sqlite的几个经常使用方法 --转

http://www.cnblogs.com/kfqcome/archive/2011/06/27/2136999.html

一．使用流程

要使用sqlite，须要从sqlite官网下载到三个文件，分别为sqlite3.lib，sqlite3.dll，sqlite3.h，而后再在本身的工程中配置好头文件和库文件，同时将dll文件放到当前目录下，就完成配置可使用sqlite了。

使用的过程根据使用的函数大体分为以下几个过程：

• sqlite3_open()
• sqlite3_prepare()
• sqlite3_step()
• sqlite3_column()
• sqlite3_finalize()
• sqlite3_close()

这几个过程是概念上的说法，而不彻底是程序运行的过程，如sqlite3_column()表示的是对查询得到一行里面的数据的列的各个操做统称，实际上在sqlite中并不存在这个函数。

1．  sqlite3_open()：打开数据库

在操做数据库以前，首先要打开数据库。这个函数打开一个sqlite数据库文件的链接而且返回一个数据库链接对象。这个操做同时程序中的第一个调用的sqlite函数，同时也是其余sqlite api的先决条件。许多的sqlite接口函数都须要一个数据库链接对象的指针做为它们的第一个参数。

函数定义

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 */

);

 

说明：

假如这个要被打开的数据文件不存在，则一个同名的数据库文件将被建立。若是使用sqlite3_open和sqlite3_open_v2的话，数据库将采用UTF-8的编码方式，sqlite3_open16采用UTF-16的编码方式

返回值：

若是sqlite数据库被成功打开（或建立），将会返回SQLITE_OK，不然将会返回错误码。Sqlite3_errmsg()或者sqlite3_errmsg16能够用于得到数据库打开错误码的英文描述，这两个函数定义为：

const char *sqlite3_errmsg(sqlite3*);

const void *sqlite3_errmsg16(sqlite3*);

        

参数说明：

filename：须要被打开的数据库文件的文件名，在sqlite3_open和sqlite3_open_v2中这个参数采用UTF-8编码，而在sqlite3_open16中则采用UTF-16编码

ppDb：一个数据库链接句柄被返回到这个参数，即便发生错误。惟一的一场是若是sqlite不能分配内存来存放sqlite对象，ppDb将会被返回一个NULL值。

flags：做为数据库链接的额外控制的参数，能够是SQLITE_OPEN_READONLY，SQLITE_OPEN_READWRITE和SQLITE_OPEN_READWRITE|SQLITE_OPEN_CREATE中的一个，用于控制数据库的打开方式，能够和SQLITE_OPEN_NOMUTEX，SQLITE_OPEN_FULLMUTEX， SQLITE_OPEN_SHAREDCACHE，以及SQLITE_OPEN_PRIVATECACHE结合使用，具体的详细状况能够查阅文档

 

 

 

 

2．  Sqlite3_prepare()

这个函数将sql文本转换成一个准备语句（prepared statement）对象，同时返回这个对象的指针。这个接口须要一个数据库链接指针以及一个要准备的包含SQL语句的文本。它实际上并不执行（evaluate）这个SQL语句，它仅仅为执行准备这个sql语句

函数定义（仅列出UTF-8的）

int sqlite3_prepare(

  sqlite3 *db,            /* Database handle */

  const char *zSql,       /* SQL statement, UTF-8 encoded */

  int nByte,              /* Maximum length of zSql in bytes. */

  sqlite3_stmt **ppStmt,  /* OUT: Statement handle */

  const char **pzTail     /* OUT: Pointer to unused portion of zSql */

);

int sqlite3_prepare_v2(

  sqlite3 *db,            /* Database handle */

  const char *zSql,       /* SQL statement, UTF-8 encoded */

  int nByte,              /* Maximum length of zSql in bytes. */

  sqlite3_stmt **ppStmt,  /* OUT: Statement handle */

  const char **pzTail     /* OUT: Pointer to unused portion of zSql */

);

 

参数：

db：数据指针

zSql：sql语句，使用UTF-8编码

nByte：若是nByte小于0，则函数取出zSql中从开始到第一个0终止符的内容；若是nByte不是负的，那么它就是这个函数能从zSql中读取的字节数的最大值。若是nBytes非负，zSql在第一次碰见’/000/或’u000’的时候终止

pzTail：上面提到zSql在碰见终止符或者是达到设定的nByte以后结束，假如zSql还有剩余的内容，那么这些剩余的内容被存放到pZTail中，不包括终止符

ppStmt：可以使用sqlite3_step()执行的编译好的准备语句的指针，若是错误发生，它被置为NULL，如假如输入的文本不包括sql语句。调用过程必须负责在编译好的sql语句完成使用后使用sqlite3_finalize()删除它。

 

说明

若是执行成功，则返回SQLITE_OK，不然返回一个错误码。推荐在如今任何的程序中都使用sqlite3_prepare_v2这个函数，sqlite3_prepare只是用于前向兼容

 

备注

<1>准备语句（prepared statement）对象

typedef struct sqlite3_stmt sqlite3_stmt;

        

准备语句（prepared statement）对象一个表明一个简单SQL语句对象的实例，这个对象一般被称为“准备语句”或者“编译好的SQL语句”或者就直接称为“语句”。

         语句对象的生命周期经历这样的过程：

l  使用sqlite3_prepare_v2或相关的函数建立这个对象

l  使用sqlite3_bind_*()给宿主参数（host parameters）绑定值

l  经过调用sqlite3_step一次或屡次来执行这个sql

l  使用sqlite3——reset()重置这个语句，而后回到第2步，这个过程作0次或屡次

l  使用sqlite3_finalize()销毁这个对象

 

在sqlite中并无定义sqlite3_stmt这个结构的具体内容，它只是一个抽象类型，在使用过程当中通常以它的指针进行操做，而sqlite3_stmt类型的指针在其实是一个指向Vdbe的结构体得指针

<2>宿主参数(host parameters)

在传给sqlite3_prepare_v2()的sql的语句文本或者它的变量中，知足以下模板的文字将被替换成一个参数：

l  ?

l  ?NNN，NNN表明数字

l  :VVV，VVV表明字符

l  @VVV

l  $VVV

在上面这些模板中，NNN表明一个数字，VVV表明一个字母数字标记符（例如:222表示名称为222的标记符），sql语句中的参数（变量）经过上面的几个模板来指定，如

“select ? from ? “这个语句中指定了两个参数，sqlite语句中的第一个参数的索引值是1，这就知道这个语句中的两个参数的索引分别为1和2，使用”?”的话会被自动给予索引值，而使用”?NNN”则能够本身指定参数的索引值，它表示这个参数的索引值为NNN。”:VVV”表示一个名为”VVV”的参数，它也有一个索引值，被自动指定。

可使用sqlite3_bind_*()来给这些参数绑定值

 

 

 

3．  sqlite3_setp()

这个过程用于执行有前面sqlite3_prepare建立的准备语句。这个语句执行到结果的第一行可用的位置。继续前进到结果的第二行的话，只需再次调用sqlite3_setp()。继续调用sqlite3_setp()知道这个语句完成，那些不返回结果的语句（如：INSERT，UPDATE，或DELETE），sqlite3_step()只执行一次就返回

函数定义

int sqlite3_step(sqlite3_stmt*);

返回值

函数的返回值基于建立sqlite3_stmt参数所使用的函数，假如是使用老版本的接口sqlite3_prepare()和sqlite3_prepare16()，返回值会是 SQLITE_BUSY， SQLITE_DONE， SQLITE_ROW， SQLITE_ERROR 或 SQLITE_MISUSE，而v2版本的接口sqlite3_prepare_v2()和sqlite3_prepare16_v2()则会同时返回这些结果码和扩展结果码。

对全部V3.6.23.1以及其前面的全部版本，须要在sqlite3_step()以后调用sqlite3_reset()，在后续的sqlite3_ step以前。若是调用sqlite3_reset重置准备语句失败，将会致使sqlite3_ step返回SQLITE_MISUSE，可是在V3. 6.23.1之后，sqlite3_step()将会自动调用sqlite3_reset。

int sqlite3_reset(sqlite3_stmt *pStmt);

sqlite3_reset用于重置一个准备语句对象到它的初始状态，而后准备被从新执行。全部sql语句变量使用sqlite3_bind*绑定值，使用sqlite3_clear_bindings重设这些绑定。Sqlite3_reset接口重置准备语句到它代码开始的时候。sqlite3_reset并不改变在准备语句上的任何绑定值，那么这里猜想，多是语句在被执行的过程当中发生了其余的改变，而后这个语句将它重置到绑定值的时候的那个状态。

 

4．  sqlite3_column()

这个过程从执行sqlite3_step()执行一个准备语句获得的结果集的当前行中返回一个列。每次sqlite3_step获得一个结果集的列停下后，这个过程就能够被屡次调用去查询这个行的各列的值。对列操做是有多个函数，均以sqlite3_column为前缀

const void *sqlite3_column_blob(sqlite3_stmt*, int iCol);

int sqlite3_column_bytes(sqlite3_stmt*, int iCol);

int sqlite3_column_bytes16(sqlite3_stmt*, int iCol);

double sqlite3_column_double(sqlite3_stmt*, int iCol);

int sqlite3_column_int(sqlite3_stmt*, int iCol);

sqlite3_int64 sqlite3_column_int64(sqlite3_stmt*, int iCol);

const unsigned char *sqlite3_column_text(sqlite3_stmt*, int iCol);

const void *sqlite3_column_text16(sqlite3_stmt*, int iCol);

int sqlite3_column_type(sqlite3_stmt*, int iCol);

sqlite3_value *sqlite3_column_value(sqlite3_stmt*, int iCol);

说明

第一个参数为从sqlite3_prepare返回来的prepared statement对象的指针，第二参数指定这一行中的想要被返回的列的索引。最左边的一列的索引号是0，行的列数可使用sqlite3_colum_count()得到。

这些过程会根据状况去转换数值的类型，sqlite内部使用sqlite3_snprintf()去自动进行这个转换，下面是关于转换的细节表：

内部类型	请求的类型	转换
NULL	INTEGER	结果是0
NULL	FLOAT	结果是0.0
NULL	TEXT	结果是NULL
NULL	BLOB	结果是NULL
INTEGER	FLOAT	从整形转换到浮点型
INTEGER	TEXT	整形的ASCII码显示
INTEGER	BLOB	同上
FLOAT	INTEGER	浮点型转换到整形
FLOAT	TEXT	浮点型的ASCII显示
FLOAT	BLOB	同上
TEXT	INTEGER	使用atoi()
TEXT	FLOAT	使用atof()
TEXT	BLOB	没有转换
BLOB	INTEGER	先到TEXT，而后使用atoi
BLOB	FLOAT	先到TEXT，而后使用atof
BLOB	TEXT	若是须要的话添加0终止符

 

注：BLOB数据类型是指二进制的数据块，好比要在数据库中存放一张图片，这张图片就会以二进制形式存放，在sqlite中对应的数据类型就是BLOB

 

int sqlite3_column_bytes(sqlite3_stmt*, int iCol)int sqlite3_column_bytes16(sqlite3_stmt*, int iCol)两个函数返回对应列的内容的字节数，这个字节数不包括后面类型转换过程当中加上的0终止符。

下面是几个最安全和最简单的使用策略

• 先sqlite3_column_text() ，而后 sqlite3_column_bytes()
• 先sqlite3_column_blob()，而后sqlite3_column_bytes()
• 先sqlite3_column_text16()，而后sqlite3_column_bytes16()

 

 

5．  sqlite3_finalize

    int sqlite3_finalize(sqlite3_stmt *pStmt);

这个过程销毁前面被sqlite3_prepare建立的准备语句，每一个准备语句都必须使用这个函数去销毁以防止内存泄露。

在空指针上调用这个函数没有什么影响，同时能够准备语句的生命周期的任一时刻调用这个函数：在语句被执行前，一次或屡次调用sqlite_reset以后，或者在sqlite3_step任何调用以后无论语句是否完成执行

 

6．  sqlite3_close

这个过程关闭前面使用sqlite3_open打开的数据库链接，任何与这个链接相关的准备语句必须在调用这个关闭函数以前被释放

 

 

二．使用举例

 

?

#include "stdafx.h" #include "sqlite3.h" static int callback(void *NotUsed, int argc, char **argv, char **azColName) {     int i;     for(i=0; i<argc; i++){        printf("%s = %s/n", azColName[i], argv[i] ? argv[i] : "NULL");     }     printf("/n");     return 0; } #define CHECK_RC(rc,szInfo,szErrMsg,db) if(rc!=SQLITE_OK) /            {printf("%s error!/n",szInfo);/            printf("%s/n",szErrMsg);    /            sqlite3_free(szErrMsg);         /            sqlite3_close(db);              /            return 0;} int _tmain(int argc, _TCHAR* argv[]) {        sqlite3 *db;     char *dbPath="f:/test.db";     char *szErrMsg = 0;        int rc= sqlite3_open(dbPath, &db);     CHECK_RC(rc,"open database",db);     char *szSql="create table UserInfo(ID int primary key , UserName char, PassWord char);";     rc=sqlite3_exec(db,szSql,0,0,&szErrMsg);     CHECK_RC(rc,"create table",szErrMsg,db);     rc=sqlite3_exec(db,"insert into UserInfo(ID,UserName,PassWord) values(1,'kfqcome','123456')",0,0,&szErrMsg);     CHECK_RC(rc,"insert info",szErrMsg,db);     rc=sqlite3_exec(db,"insert into UserInfo(ID,UserName,PassWord) values(2,'miss wang','654321')",0,0,&szErrMsg);     CHECK_RC(rc,"insert info",szErrMsg,db);     szSql="select * from UserInfo";     rc = sqlite3_exec(db,szSql, callback, 0, &szErrMsg);     CHECK_RC(rc,"query values",szErrMsg,db);     sqlite3_close(db);     getchar();     return 0; }

　　输出的结果：

ID = 1

UserName = kfqcome

PassWord = 123456

 

ID = 2

UserName = miss wang

PassWord = 654321

 

这里执行sql语句用的是sqlite3_exec，它是前面几个函数的封装

 

int sqlite3_exec(

  sqlite3*,                                  /* An open database */

  const char *sql,                           /* SQL to be evaluated */

  int (*callback)(void*,int,char**,char**),  /* Callback function */

  void *,                                    /* 1st argument to callback */

  char **errmsg                              /* Error msg written here */

);

sqlite3_exec是sqlite3_prepare_v2，sqlite3_step()和sqlite3_finalize()的封装，能让程序屡次执行sql语句而不要写许多重复的代码。

Sqlite3_exec接口执行0或多个UTF-8编码的，分号分割的sql语句，传到第二个参数中。若是sqlite3_exec的第三个参数回调函数指针不为空，那么它会为每一个来自执行的SQL语句的结果行调用（也就是说回调函数会调用屡次，上面例子中会返回2个结果行，于是会被执行2次），第4个参数是传给回调函数的第一个参数，若是回调函数指针为空，那么回调不会发生同时结果行被忽略。

若是在执行sql语句中有错误发生，那么当前的语句的执行被中止，后续的语句也被跳过。第五个参数不为空的时候，它被分配内存并写入了错误信息，因此在sqlite3_exec后面须要调用sqlite3_free去释放这个对象以防止内存泄露

 

回调函数：

int (*callback)(void*,int,char**,char**),  /* Callback function */

         第一个参数经过sqlite3_exec的第第四个参数传入的

         第二个参数是结果行的列数

         第三个参数是行中列数据的指针

         第四个参数是行中列名称的指针