/* 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 的字节数,包含 '\0' */
    sqlite3_stmt** ppStmt,/* 输出:预编译语句句柄 */
    const char** pszTail    /* 输出:指向 sql 语句中未使用的部分 */
);

说明:
    要执行一条 sql 查询,其必须先被编译成字节码,然后才能被其它函数使用.
    如果 nbytes 小于零,sql 语句则以第一个 '\0'终结. 如果它非负,则为读取的最大长度. 当  nbytes 大于 0 时,则读取指定长度,如果'\0'先被读到,则以'\0'结束. 如果用户知道被传入的 sql 语句是以 '\0' 结尾的,那么有一个更好的做法是:把nbytes的值设为该字符串的长度(包含'\0'),这样可以避免 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;