SQlite数据库的C编程接口（二） 数据库连接 ——《Using SQlite》读书笔记

bestjoe

　　SQlite数据库的C编程接口（二） 数据库连接 by斜风细雨QQ：253786989
2012-02-03
　　库初始化


[cpp]
view plaincopyprint?

• intsqlite3_initialize(void);
  
• 
  intsqlite3_shutdown(void);
  

int sqlite3_initialize(void);
int sqlite3_shutdown(void);
　　在使用SQliteLibrary之前，首先应该调用sqlite3_initialize函数，该函数将分配资源，初始化一些必要的数据结构。与之配合使用的另一个函数是sqlite3_shutdown，该函数用来释放由sqlite3_initialize分配的资源。不过在很多客户的应用程序中通常直接调用sqlite3_open或者另一些主要的API函数，这些函数会自动初始化SQlitelibrary（如果它还没有被初始化的话）。不过还是推荐客户应用程序显示调用这两个APIs函数来完成SQlitelibrary的初始化和最后的清理工作。
　　打开数据库


[cpp]
view plaincopyprint?

• intsqlite3_open(
  
• 
  constchar*filename,/*Databasefilename(UTF-8)*/
  
• 
  sqlite3**ppDb/*OUT:SQLitedbhandle*/
  
• );
  
• 
  
• 
  intsqlite3_open16(
  
• 
  constvoid*filename,/*Databasefilename(UTF-16)*/
  
• 
  sqlite3**ppDb/*OUT:SQLitedbhandle*/
  
• );
  
• 
  
• 
  intsqlite3_open_v2(
  
• 
  constchar*filename,/*Databasefilename(UTF-8)*/
  
• 
  sqlite3**ppDb,/*OUT:SQLitedbhandle*/
  
• 
  intflags,/*Flags*/
  
• 
  constchar*zVfs/*NameofVFSmoduletouse*/
  
• );
  

int sqlite3_open(
const char *filename,   /* Database filename (UTF-8) */
sqlite3 **ppDb          /* OUT: SQLite db handle */
);
int sqlite3_open16(
const void *filename,   /* Database filename (UTF-16) */
sqlite3 **ppDb          /* OUT: SQLite db handle */
);
int sqlite3_open_v2(
const char *filename,   /* Database filename (UTF-8) */
sqlite3 **ppDb,         /* OUT: SQLite db handle */
int flags,              /* Flags */
const char *zVfs        /* Name of VFS module to use */
);

　　在执行任何SQL语句之前，必须首先连接到一个数据库，也就是打开或者新建一个SQlite3数据库文件。连接数据库由sqlite3_open函数完成，它一共有上面3个版本。其中sqlite3_open函数假定SQlite3数据库文件名为UTF-8编码，sqlite3_open_v2是它的加强版。sqlite3_open16函数假定SQlite3数据库文件名为UTF-16（Unicode宽字符）编码。
　　所有这三个函数，参数filename是要连接的SQlite3数据库文件名字符串。参数ppDb看起来有点复杂，它是一个指向指针的指针。当调用sqlite3_open_xxx函数时，该函数将分配一个新的SQlite3数据结构，然后初始化，然后将指针ppDb指向它。所以客户应用程序可以通过sqlite3_open_xxx函数连接到名为filename的数据库，并通过参数ppDb返回指向该数据库数据结构的指针。
　　示例代码：

[cpp]
view plaincopyprint?

• sqlite3*pDB=NULL;
  
• 
  Statusrc=sqlite3_open("database.sqlite3",&pDB);
  

  sqlite3 *pDB = NULL;
Status rc = sqlite3_open("database.sqlite3", &pDB);

　　对于sqlite3_open和sqlite3_open16函数，如果可能将以可读可写的方式打开数据库，否则以只读的方式打开数据库。如果要打开的数据库文件不存在，就新建一个。对于sqlite3_open_v2函数，情况就要复杂一些了，因为这个v2版本的函数强大就强大在它可以对打开（连接）数据库的方式进行控制，具体是通过它的参数flags来完成。sqlite3_open_v2函数只支持UTF-8编码的SQlite3数据库文件。
　　如flags设置为SQLITE_OPEN_READONLY，则SQlite3数据库文件以只读的方式打开，如果该数据库文件不存在，则sqlite3_open_v2函数执行失败，返回一个error。如果flags设置为SQLITE_OPEN_READWRITE，则SQlite3数据库文件以可读可写的方式打开，如果该数据库文件本身被操作系统设置为写保护状态，则以只读的方式打开。如果该数据库文件不存在，则sqlite3_open_v2函数执行失败，返回一个error。如果flags设置为SQLITE_OPEN_READWRITE|SQLITE_OPEN_CREATE，则SQlite3数据库文件以可读可写的方式打开，如果该数据库文件不存在则新建一个。这也是sqlite3_open和sqlite3_open16函数的默认行为。除此之外，flags还可以设置为其他标志，具体可以查看SQlite官方文档。
　　参数zVfs允许客户应用程序命名一个虚拟文件系统（VirtualFileSystem）模块，用来与数据库连接。VFS作为SQlitelibrary和底层存储系统（如某个文件系统）之间的一个抽象层，通常客户应用程序可以简单的给该参数传递一个NULL指针，以使用默认的VFS模块。
　　对于UTF-8编码的SQlite3数据库文件，推荐使用sqlite3_open_v2函数进行连接，它可以对数据库文件的打开和处理操作进行更多的控制。
　　SQlite3数据库文件的扩展名没有一个标准定义，比较流行的选择是.sqlite3、.db、.db3。不过在Windows系统平台上，不推荐使用.sdb作为SQlite3数据库文件的扩展名，据说这会导致IO速度显著减慢，因为.sdb扩展名有其特殊用义。
　　关闭数据库


[cpp]
view plaincopyprint?

• intsqlite3_close(sqlite3*);
  

int sqlite3_close(sqlite3 *);
　　在使用完SQlite数据库之后，需要调用sqlite3_close函数关闭数据库连接，释放数据结构所关联的内存，删除所有的临时数据项。如果在调用sqlite3_close函数关闭数据库之前，还有某些没有完成的（nonfinalized）SQL语句，那么sqlite3_close函数将会返回SQLITE_BUSY错误。客户程序员需要finalize所有的预处理语句（preparedstatement）之后再次调用sqlite3_close。
　　示例代码


[cpp]
view plaincopyprint?

• #include"sqlite3.h"
  
• 
  #include<stdlib.h>
  
• 
  intmain(intargc,char**argv)
  
• {
  
• 
  Char*file="database.sqlite3";
  
• sqlite3*pDB=NULL;
  
• 
  intrc=0;
  
• 
  
• sqlite3_initialize();
  
• rc=sqlite3_open_v2(file,&db,SQLITE_OPEN_READWRITE|
  
• SQLITE_OPEN_CREATE,NULL);
  
• 
  if(rc!=SQLITE_OK)
  
• {
  
• sqlite3_close(db);
  
• exit(-1);
  
• }
  
• 
  
• 
  /*performdatabaseoperations*/
  
• 
  
• sqlite3_close(db);
  
• sqlite3_shutdown()
  
• }
  

#include "sqlite3.h"
#include <stdlib.h>
int main( int argc, char **argv )
{
Char *file = "database.sqlite3";
sqlite3 *pDB = NULL;
int rc = 0;
sqlite3_initialize( );
rc = sqlite3_open_v2( file, &db, SQLITE_OPEN_READWRITE |
SQLITE_OPEN_CREATE, NULL );
if ( rc != SQLITE_OK)
{
sqlite3_close( db );
exit( -1 );
}
/*  perform database operations  */
sqlite3_close( db );
sqlite3_shutdown( )
}

　　SQlite数据库的C编程接口（二） 数据库连接 by斜风细雨QQ：253786989
2012-02-03





　　SQlite数据库的C编程接口（二） 数据库连接 by斜风细雨QQ：253786989
2012-02-03
　　库初始化


[cpp]
view plaincopyprint?

• intsqlite3_initialize(void);
  
• 
  intsqlite3_shutdown(void);
  

int sqlite3_initialize(void);
int sqlite3_shutdown(void);
　　在使用SQliteLibrary之前，首先应该调用sqlite3_initialize函数，该函数将分配资源，初始化一些必要的数据结构。与之配合使用的另一个函数是sqlite3_shutdown，该函数用来释放由sqlite3_initialize分配的资源。不过在很多客户的应用程序中通常直接调用sqlite3_open或者另一些主要的API函数，这些函数会自动初始化SQlitelibrary（如果它还没有被初始化的话）。不过还是推荐客户应用程序显示调用这两个APIs函数来完成SQlitelibrary的初始化和最后的清理工作。
　　打开数据库


[cpp]
view plaincopyprint?

• intsqlite3_open(
  
• 
  constchar*filename,/*Databasefilename(UTF-8)*/
  
• 
  sqlite3**ppDb/*OUT:SQLitedbhandle*/
  
• );
  
• 
  
• 
  intsqlite3_open16(
  
• 
  constvoid*filename,/*Databasefilename(UTF-16)*/
  
• 
  sqlite3**ppDb/*OUT:SQLitedbhandle*/
  
• );
  
• 
  
• 
  intsqlite3_open_v2(
  
• 
  constchar*filename,/*Databasefilename(UTF-8)*/
  
• 
  sqlite3**ppDb,/*OUT:SQLitedbhandle*/
  
• 
  intflags,/*Flags*/
  
• 
  constchar*zVfs/*NameofVFSmoduletouse*/
  
• );
  

int sqlite3_open(
const char *filename,   /* Database filename (UTF-8) */
sqlite3 **ppDb          /* OUT: SQLite db handle */
);
int sqlite3_open16(
const void *filename,   /* Database filename (UTF-16) */
sqlite3 **ppDb          /* OUT: SQLite db handle */
);
int sqlite3_open_v2(
const char *filename,   /* Database filename (UTF-8) */
sqlite3 **ppDb,         /* OUT: SQLite db handle */
int flags,              /* Flags */
const char *zVfs        /* Name of VFS module to use */
);

　　在执行任何SQL语句之前，必须首先连接到一个数据库，也就是打开或者新建一个SQlite3数据库文件。连接数据库由sqlite3_open函数完成，它一共有上面3个版本。其中sqlite3_open函数假定SQlite3数据库文件名为UTF-8编码，sqlite3_open_v2是它的加强版。sqlite3_open16函数假定SQlite3数据库文件名为UTF-16（Unicode宽字符）编码。
　　所有这三个函数，参数filename是要连接的SQlite3数据库文件名字符串。参数ppDb看起来有点复杂，它是一个指向指针的指针。当调用sqlite3_open_xxx函数时，该函数将分配一个新的SQlite3数据结构，然后初始化，然后将指针ppDb指向它。所以客户应用程序可以通过sqlite3_open_xxx函数连接到名为filename的数据库，并通过参数ppDb返回指向该数据库数据结构的指针。
　　示例代码：

[cpp]
view plaincopyprint?

• sqlite3*pDB=NULL;
  
• 
  Statusrc=sqlite3_open("database.sqlite3",&pDB);
  

  sqlite3 *pDB = NULL;
Status rc = sqlite3_open("database.sqlite3", &pDB);

　　对于sqlite3_open和sqlite3_open16函数，如果可能将以可读可写的方式打开数据库，否则以只读的方式打开数据库。如果要打开的数据库文件不存在，就新建一个。对于sqlite3_open_v2函数，情况就要复杂一些了，因为这个v2版本的函数强大就强大在它可以对打开（连接）数据库的方式进行控制，具体是通过它的参数flags来完成。sqlite3_open_v2函数只支持UTF-8编码的SQlite3数据库文件。
　　如flags设置为SQLITE_OPEN_READONLY，则SQlite3数据库文件以只读的方式打开，如果该数据库文件不存在，则sqlite3_open_v2函数执行失败，返回一个error。如果flags设置为SQLITE_OPEN_READWRITE，则SQlite3数据库文件以可读可写的方式打开，如果该数据库文件本身被操作系统设置为写保护状态，则以只读的方式打开。如果该数据库文件不存在，则sqlite3_open_v2函数执行失败，返回一个error。如果flags设置为SQLITE_OPEN_READWRITE|SQLITE_OPEN_CREATE，则SQlite3数据库文件以可读可写的方式打开，如果该数据库文件不存在则新建一个。这也是sqlite3_open和sqlite3_open16函数的默认行为。除此之外，flags还可以设置为其他标志，具体可以查看SQlite官方文档。
　　参数zVfs允许客户应用程序命名一个虚拟文件系统（VirtualFileSystem）模块，用来与数据库连接。VFS作为SQlitelibrary和底层存储系统（如某个文件系统）之间的一个抽象层，通常客户应用程序可以简单的给该参数传递一个NULL指针，以使用默认的VFS模块。
　　对于UTF-8编码的SQlite3数据库文件，推荐使用sqlite3_open_v2函数进行连接，它可以对数据库文件的打开和处理操作进行更多的控制。
　　SQlite3数据库文件的扩展名没有一个标准定义，比较流行的选择是.sqlite3、.db、.db3。不过在Windows系统平台上，不推荐使用.sdb作为SQlite3数据库文件的扩展名，据说这会导致IO速度显著减慢，因为.sdb扩展名有其特殊用义。
　　关闭数据库


[cpp]
view plaincopyprint?

• intsqlite3_close(sqlite3*);
  

int sqlite3_close(sqlite3 *);
　　在使用完SQlite数据库之后，需要调用sqlite3_close函数关闭数据库连接，释放数据结构所关联的内存，删除所有的临时数据项。如果在调用sqlite3_close函数关闭数据库之前，还有某些没有完成的（nonfinalized）SQL语句，那么sqlite3_close函数将会返回SQLITE_BUSY错误。客户程序员需要finalize所有的预处理语句（preparedstatement）之后再次调用sqlite3_close。
　　示例代码


[cpp]
view plaincopyprint?

• #include"sqlite3.h"
  
• 
  #include<stdlib.h>
  
• 
  intmain(intargc,char**argv)
  
• {
  
• 
  Char*file="database.sqlite3";
  
• sqlite3*pDB=NULL;
  
• 
  intrc=0;
  
• 
  
• sqlite3_initialize();
  
• rc=sqlite3_open_v2(file,&db,SQLITE_OPEN_READWRITE|
  
• SQLITE_OPEN_CREATE,NULL);
  
• 
  if(rc!=SQLITE_OK)
  
• {
  
• sqlite3_close(db);
  
• exit(-1);
  
• }
  
• 
  
• 
  /*performdatabaseoperations*/
  
• 
  
• sqlite3_close(db);
  
• sqlite3_shutdown()
  
• }
  

#include "sqlite3.h"
#include <stdlib.h>
int main( int argc, char **argv )
{
Char *file = "database.sqlite3";
sqlite3 *pDB = NULL;
int rc = 0;
sqlite3_initialize( );
rc = sqlite3_open_v2( file, &db, SQLITE_OPEN_READWRITE |
SQLITE_OPEN_CREATE, NULL );
if ( rc != SQLITE_OK)
{
sqlite3_close( db );
exit( -1 );
}
/*  perform database operations  */
sqlite3_close( db );
sqlite3_shutdown( )
}

　　SQlite数据库的C编程接口（二） 数据库连接 by斜风细雨QQ：253786989
2012-02-03