Sqite常用API接口说明

（1） sqlite3_open

概述：

   打开一个Sqlite数据库；

定义：

代码

   
     

    
      
    
       1 
    
      int
    
       sqlite3_open(

    
       2 
    
       
    
      const
    
       
    
      char
    
       
    
      *
    
      filename, 
    
      /*
    
       Database filename (UTF-8) 
    
      */
    
      

    
       3 
    
       sqlite3 
    
      **
    
      ppDb 
    
      /*
    
       OUT: SQLite db handle 
    
      */
    
      

    
       4 
    
      );

    
       5 
    
       
    
      int
    
       sqlite3_open16(

    
       6 
    
       
    
      const
    
       
    
      void
    
       
    
      *
    
      filename, 
    
      /*
    
       Database filename (UTF-16) 
    
      */
    
      

    
       7 
    
       sqlite3 
    
      **
    
      ppDb 
    
      /*
    
       OUT: SQLite db handle 
    
      */
    
      

    
       8 
    
      );

    
       9 
    
      
    
      int
    
       sqlite3_open_v2(

    
      10 
    
       
    
      const
    
       
    
      char
    
       
    
      *
    
      filename, 
    
      /*
    
       Database filename (UTF-8) 
    
      */
    
      

    
      11 
    
       sqlite3 
    
      **
    
      ppDb, 
    
      /*
    
       OUT: SQLite db handle 
    
      */
    
      

    
      12 
    
       
    
      int
    
       flags, 
    
      /*
    
       Flags 
    
      */
    
      

    
      13 
    
       
    
      const
    
       
    
      char
    
       
    
      *
    
      zVfs 
    
      /*
    
       Name of VFS module to use 
    
      */
    
      

    
      14 
    
      );
   
     

 

说明：

   该函数通过“filename”参数打开一个Sqlite数据库文件，返回数据库连接的句柄ppDb；

对于文件名参数，存在四种情况：

（1）文件名表示一个已经存在的数据库文件，则该函数打开这个Sqlite数据库，返回连接；

（2）文件名表示一个并不存在的文件路径，则通过该函数可以创建一个新的Sqlite数据库，并返回连接；

（3）文件名为空字符串，该函数会在磁盘上创建一个临时的、私有的Sqlite数据库，不过这个数据库会在关闭数据库，即sqlite3_close()时自动删除；

（4）文件名为“:memory: ”，则该函数会创建一个临时的、私有的内存数据库，并在数据库关闭时自动销毁；

如果数据库打开成功，则会返回SQLITE_OK，否则返回其他错误代码。

（以上参考自： http://www.sqlite.org/c3ref/open.html ）

待续...