sqlite 编程接口

• 数据库的打开和关闭

int sqlite3_open(const char*,sqlite3**);
int sqlite3_close(sqlite3*);

sqlite3为一个结构，它代指一个数据库连接，之后调用的大部分API函数都需要使用它作为其中一个参数。sqlite3_open的第一个参数为文件名字符串。两个函数都是成功返回sqlITE_OK，失败返回错误码。可以使用sqlite3_errmsg函数获得错误描述:

const char *sqlite3_errmsg(sqlite3*);

• 数据库操作-执行sql语句

int sqlite3_prepare(sqlite3*,const char*,int,sqlite3_stmt**,

const char**);
int sqlite3_finalize(sqlite3_stmt*);
int sqlite3_reset(sqlite3_stmt*);

sqlite3_stmt结构代指一条sql语句，上述三个函数的功能就是创建、销毁和重置sqlite3_stmt结构。sqlite3_prepare函数的第二个参数为sql语句字符串，第三个参数为字符串长度。如果传入的sql语句字符串超出了一条sql语句，则第五个参数返回sql语句字符串中指向下一条sql语句的char指针。sql语句字符串可以带?号，它是sql语句中的不确定部分，需要对它另外赋值。

int sqlite3_bind_text(sqlite3_stmt*,int n,void(*)(void*));

sqlite3_bind_*系列函数有好多，这里只对sqlite3_bind_text进行一下说明，sqlite3_bind_text的第二个参数为序号（从1开始），第三个参数为字符串值，第四个参数为字符串长度。sqlite3_bind_text的第五个参数为一个函数指针，sqlITE3执行完操作后回调此函数，通常用于释放字符串占用的内存。（这个函数指针参数具体怎么使用，我现在还不清楚）。此参数有两个常数，sqlITE_STATIC告诉sqlite3_bind_text函数字符串为常量，可以放心使用；而sqlITE_TRANSIENT会使得sqlite3_bind_text函数对字符串做一份拷贝。一般使用这两个常量参数来调用sqlite3_bind_text。
statement准备好了以后，就是操作的执行了。

int sqlite3_step(sqlite3_stmt*);

它的返回值相对有些特殊。返回sqlITE_BUSY表示暂时无法执行操作，sqlITE_DONE表示操作执行完毕，sqlITE_ROW表示执行完毕并且有返回（执行select语句时）。当返回值为sqlITE_ROW时，我们需要对查询结果进行处理，sqlITE3提供sqlite3_column_*系列函数。

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

其中参数iCol为列的序号，从0开始。如果返回值有多行，则可以再次调用sqlite3_step函数，然后由sqlite3_column_*函数取得返回值。


使用上述这些函数基本上可以完成对sqlITE3数据库的操作了（不过我这里只针对text数据类型做了说明）。当然，sqlite3还有很多其它的接口函数，以后再慢慢摸索吧，现在只是刚开始。

下面是一段示例代码：

#include <stdio.h>
#include "sqlite3.h"

int main(){
sqlite3 *db;
char *zErrMsg = NULL;
int rv;
char szsql[128] = { 0 };
sqlite3_stmt *stmt;

rv = sqlite3_open("test.db",&db);
if( rv ){
fprintf(stderr,"Can't open database: %s\n",sqlite3_errmsg(db));
sqlite3_close(db);
return 1;
}
else
fprintf(stderr,"sqlite3_open OK\n");

//这里查询时，假定数据库中存在表test，并且有一列为COL1(text类型)

strcpy(szsql,"SELECT COL1 FROM test where COL1=?");
rv = sqlite3_prepare(db,szsql,128,&stmt,NULL);
if( rv != sqlITE_OK ) {
fprintf(stderr,"sqlite3_prepare(%d): %s\n",rv,sqlite3_errmsg(db));
return -1;
}

rv = sqlite3_bind_text(stmt,1,"VALUE1",strlen("VALUE1"),sqlITE_STATIC);
if( rv != sqlITE_OK ) {
fprintf(stderr,"sqlite3_bind_text(%d): %s\n",sqlite3_errmsg(db));
return -1;
}

rv = sqlite3_step(stmt);
if( (rv != sqlITE_OK) && (rv != sqlITE_DONE) && (rv != sqlITE_ROW) ) {
fprintf(stderr,"sqlite3_step(%d): %s\n",sqlite3_errmsg(db));
return -1;
}

while( rv == sqlITE_ROW ){
fprintf(stderr,"result: %s\n",sqlite3_column_text(stmt,0));
rv = sqlite3_step(stmt);
}

rv = sqlite3_finalize(stmt);
if( rv != sqlITE_OK ) {
fprintf(stderr,"sqlite3_finalize(%d): %s\n",sqlite3_errmsg(db));
return -1;
}

sqlite3_close(db); return 0; }