sqlITE是一款非常小巧的嵌入式开源数据库软件,目前最新的版本是3.5.0 alpha版(最新版本可以参考www.sqlite.org)。它使用一个文件存储整个数据库,操作十分方便。它的最大优点是使用方便,功能相比于其它大型数据库来说,确实有些差距。但是性能表现上,sqlITE并不逊色。 现在来看它的编程接口,我主要使用的是C语言。由于3.5.0刚出来,可能不稳定,所以我使用的是3.4.2版本。sqlITE提供一种单文件源码包形式 (http://www.sqlite.org/sqlite-amalgamation-3_4_2.zip),它只包含两个文件:sqlite3.c和sqlite3.h,使用时只需将此两个文件一起编译即可。sqlITE提供的C函数接口在sqlite3.h中都有定义,sqlite的API文档中(http://www.sqlite.org/capi3ref.html)有详细的描述。刚开始接触sqlite,只学会了最基本的一些数据库操作接口,复杂的东西留待将来慢慢研究。如果你也刚开始接触sqlite的API,可以先看一下http://www.sqlite.org/capi3.html。
int sqlite3_open(const char*,sqlite3**); int sqlite3_close(sqlite3*);
sqlite3为一个结构,它代指一个数据库连接,之后调用的大部分API函数都需要使用它作为其中一个参数。sqlite3_open的第一个参数为文件名字符串。两个函数都是成功返回sqlITE_OK,失败返回错误码。可以使用sqlite3_errmsg函数获得错误描述:
const char *sqlite3_errmsg(sqlite3*);
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还有很多其它的接口函数,以后再慢慢摸索吧,现在只是刚开始。
原文链接:https://www.f2er.com/sqlite/201135.html