SQLITE3 C语言接口 API 函数简介

int sqlite3_open( const char* filename,/* 数据库文件名,必须为 UTF-8 格式 */

sqlite3** ppDB /* 输出: SQLite 数据库句柄 */);

说明: 该函数打开由 filename 指定的数据库,一个数据库连接句柄由 *ppDB 返回(不管是否发生了一个错误). 唯一异常是 SQLite 无法为 SQLite 对象分配内存空间,此时将返回 NULL. 如果数据库被成功打开(和/或 创建),函数返回 SQLITE_OK(0). 否则返回一个错误码,可以通过 sqlite3_errmsg() 取得错误原因. 无论是否成功打开数据库,都应该使用 sqlite3_close() 关闭数据库连接.

示例: int ret = 0; char* filename = "./nbsg.db"; sqlite3* pDB = NULL; to_utf8(filename);

ret = sqlite3_open(filename,&pDB);

if(ret != SQLITE_OK)

...

int sqlite3_close( sqlite3* pDB /* 由 sqlite3_open 或基相关的函数打开的 SQLite 对象句柄 */ );

说明: 该函数用来析构 sqlite3 对象. 返回 SQLITE_OK 表示对象被成功析构,以及所有相关的资源被成功回收应用程序必须在关闭之前 "完成(finalize)" 所有的 "预编译语句(prepared statements)",并且关闭所有的 "二进制句柄绑定(BLOB handle)",如果在关闭时还有未完成的预编译语句或二进制句柄,那么函数返回 SQLITE_BUSY(5).

示例: if(pDB != NULL) { sqlite3_close(pDB); pDB = NULL; }

/* sqlite3_exec(),2012-05-28 */

int sqlite3_exec(
    sqlite3* pDB,/* sqlite3句柄 */
    const char* sql,/* 被执行的 SQL 语句 */
    int (*callback)(void*,int,char**,char**),/* 执行/查询回调函数 */
    void* pvoid,/* 传递给回调函数的第一个参数 */
    char**errmsg    /* 错误输出信息 */
);

说明:
    该函数用来执行若干条 SQL 语句.
    该函数包裹了先前版本的 sqlite3_prepare(),sqlte3_step() 和 sqlite3_finalize() 函数,这样,用户就可以执行简单的代码执行多条 SQL 语句.
    sqlite3_exec()接口执行多条以";"分隔的SQL语句. 如果回调函数不为 NULL,则它对每一个行查询结果都会调用该回调函数. 如果没有回调函数被指定,sqlite3_exec() 只是简单地忽略查询结果.
    当在执行该SQL语句发生错误时,执行将发生中断,并且后面的语句也全部被忽略. 如果 errmsg 参数不为空任何错误信息将会被写进由 sqlite3_malloc() 得到的的内存空间中,即 errmsg 指向的内存. 为了避免内存泄漏,应用程序应该在不需要该错误信息后立即调用 sqlite3_free() 释放该内存空间. 如果 errmsg 参数不为 NULL,并且没有错误发生,errmsg 被设置为 NULL.
    如果回调函数返回非零,sqlite3_exec() 立即中断查询,并且不再执行后续的 SQL 语句,也不再调用回调函数,sqlite3_exec() 将返回 SQLITE_ABORT 结束执行.
示例:
    sqlite3_exec(pDB,to_utf8("delete from tablename where id=123;"),NULL,NULL);
    sqlite3_exec(pDB,to_utf8("create table if not exists tablename (id integer primary key,name text);"),to_utf8("insert into tablename (name) values ('女孩不哭');"),NULL);
    if(sqlite3_exec(pDB,to_utf8("select * from tablename;"),sqlite_callback,&pszErrMsg) != SQLITE_OK)
    {
        ...
        sqlite3_free(pszErrMsg);
        pszErrMsg = NULL;
    }

/* sqlite3_prepare(),sqlite3_step(),sqlite3_finalize() */
int sqlite3_prepare(
    sqlite3* pDB,/* 成功打开的数据库句柄 */
    const char* sql,/* UTF8编码的 SQL 语句 */
    int nbytes,/* 参数 sql 的字节数,包含 '' */
    sqlite3_stmt** ppStmt,/* 输出:预编译语句句柄 */
    const char** pszTail    /* 输出:指向 sql 语句中未使用的部分 */
);

说明:
    要执行一条 SQL 查询,其必须先被编译成字节码,然后才能被其它函数使用.
    如果 nbytes 小于零,sql 语句则以第一个 ''终结. 如果它非负,则为读取的最大长度. 当  nbytes 大于 0 时,则读取指定长度,如果''先被读到,则以''结束. 如果用户知道被传入的 sql 语句是以 '' 结尾的,那么有一个更好的做法是:把nbytes的值设为该字符串的长度(包含''),这样可以避免 SQLite 复制该字符串的一份拷贝,以提高程序的效率.
    如果 pszTail 不为 NULL,则 *pszTail 指向 sql 中第一个被传入的 SQL 语句的结尾. 该函数只编译 sql 的第一个语句,所以 *pszTail 指向的内容则是未被编译的.
    *ppStmt 指向一条可以被 sqlie3_step() 函数使用的预编译语句. 如果有错误发生,*pszStmt 的值为NULL.
    调用者应该使用 sqlite3_finalize() 删掉被预编译的语句.
    如果函数成功,返回 SQLITE_OK,否则返回一个错误码.

int sqlite3_step(
    sqlite3_stmt* ppStmt    /* 一条被预编译的 sql 语句 */
);
说明:
    当一条语句被 sqlite3_prepare() 或其相关的函数预编译后,sqlite3_step() 必须被调用一次或多次来评估该预编译语句.
    该函数的详细行为依赖于由 sqlite3_prepare()(或其相关的函数) 产生的是一条怎样的预编译语句.
    函数将返回一个以下的结果来标识其执行结果:
        SQLITE_BUSY:忙碌. 数据库引擎无法锁定数据去完成其工作. 但可以多次尝试.
        SQLITE_DONE:完成. sql 语句已经被成功地执行. 在调用 sqlite_reset() 之前,当前预编译的语句不应该被 sqlite3_step() 再次调用.
        SQLITE_ROW:查询时产生了结果. 此时可以通过相关的"数据访问函数(column access functions)"来取得数据. sqlite3_step() 的再一次调用将取得下一条查询结果.
        SQLITE_ERROR:发生了错误. 此时可以通过 sqlite3_errmmsg() 取得相关的错误信息. sqlite3_step() 不能被再次调用.
        SQLITE_MISUSE:不正确的库的使用. 该函数使用不当.
其它:
    有关预编译的使用,将在以后的函数介绍中详细说明.

int sqlite3_finalize(
    sqlite3_stmt* pStmt    /* 被预编译的语句 */
);
说明:
    该函数用来删除一条被预编译的 sql 语句
示例:
    sqlite3_finalize(pStmt);
    pStmt = NULL;

（编辑：李大同）

【声明】本站内容均来自网络，其相关言论仅代表作者个人观点，不代表本站立场。若无意侵犯到您的权利，请及时与联系站长删除相关内容!