【正文】 int sqlite3_create_function16( sqlite3*, const void *zFunctionName, int nArg, int eTextRep, void*, void (*xFunc)(sqlite3_context*,int,sqlite3_value**), void (*xStep)(sqlite3_context*,int,sqlite3_value**), void (*xFinal)(sqlite3_context*) )。 const void *sqlite3_column_text16(sqlite3_stmt*, int iCol)。 long long int sqlite3_column_int64(sqlite3_stmt*, int iCol)。 const char *sqlite3_column_decltype(sqlite3_stmt *, int iCol)。如果SQL返回了一個單行結(jié)果集，sqlite3_step() 函數(shù)將返回 SQLITE_ROW , 如果SQL語句執(zhí)行成功或者正常將返回 SQLITE_DONE , 否則將返回錯誤代碼. 如果不能打開數(shù)據(jù)庫文件則會返回 SQLITE_BUSY . 如果函數(shù)的返回值是 SQLITE_ROW, 那么下邊的這些方法可以用來獲得記錄集行中的數(shù)據(jù): const void *sqlite3_column_blob(sqlite3_stmt*, int iCol)。 int sqlite3_bind_text(sqlite3_stmt*, int, const char*, int n, void(*)(void*))。 int sqlite3_bind_double(sqlite3_stmt*, int, double)。 int sqlite3_prepare16(sqlite3*, const void*, int, sqlite3_stmt**, const void**)。sqlite3_open() 函數(shù)返回一個整數(shù)錯誤代碼,而不是像第二版中一樣返回一個指向sqlite3結(jié)構(gòu)體的指針. sqlite3_open() 和 sqlite3_open16() 的不同之處在于sqlite3_open16() 使用UTF16編碼(使用本地主機(jī)字節(jié)順序)傳遞數(shù)據(jù)庫文件名. 如果要創(chuàng)建新數(shù)據(jù)庫, sqlite3_open16() 將內(nèi)部文本轉(zhuǎn)換為UTF16編碼, 反之sqlite3_open() 將文本轉(zhuǎn)換為UTF8編碼.打開或者創(chuàng)建數(shù)據(jù)庫的命令會被緩存,直到這個數(shù)據(jù)庫真正被調(diào)用的時候才會被執(zhí)行. 而且允許使用PRAGMA聲明來設(shè)置如本地文本編碼或默認(rèn)內(nèi)存頁面大小等選項(xiàng)和參數(shù).sqlite3_errcode() 通常用來獲取最近調(diào)用的API接口返回的錯誤代碼. sqlite3_errmsg() 則用來得到這些錯誤代碼所對應(yīng)的文字說明. 這些錯誤信息將以 UTF8 的編碼返回,并且在下一次調(diào)用任何SQLite API函數(shù)的時候被清除. sqlite3_errmsg16() 和 sqlite3_errmsg() 大體上相同,除了返回的錯誤信息將以 UTF16 本機(jī)字節(jié)順序編碼.SQLite3的錯誤代碼相比SQLite2沒有任何的改變,它們分別是:define SQLITE_OK 0 /* Successful result */define SQLITE_ERROR 1 /* SQL error or missing database */define SQLITE_INTERNAL 2 /* An internal logic error in SQLite */define SQLITE_PERM 3 /* Access permission denied */define SQLITE_ABORT 4 /* Callback routine requested an abort */define SQLITE_BUSY 5 /* The database file is locked */define SQLITE_LOCKED 6 /* A table in the database is locked */define SQLITE_NOMEM 7 /* A malloc() failed */define SQLITE_READONLY 8 /* Attempt to write a readonly database */define SQLITE_INTERRUPT 9 /* Operation terminated by sqlite_interrupt() */define SQLITE_IOERR 10 /* Some kind of disk I/O error occurred */define SQLITE_CORRUPT 11 /* The database disk image is malformed */define SQLITE_NOTFOUND 12 /* (Internal Only) Table or record not found */define SQLITE_FULL 13 /* Insertion failed because database is full */define SQLITE_CANTOPEN 14 /* Unable to open the database file */define SQLITE_PROTOCOL 15 /* Database lock protocol error */define SQLITE_EMPTY 16 /* (Internal Only) Database table is empty */define SQLITE_SCHEMA 17 /* The database schema changed */define SQLITE_TOOBIG 18 /* Too much data for one row of a table */define SQLITE_CONSTRAINT 19 /* Abort due to contraint violation */define SQLITE_MISMATCH 20 /* Data type mismatch */define SQLITE_MISUSE 21 /* Library used incorrectly */define SQLITE_NOLFS 22 /* Uses OS features not supported on host */define SQLITE_AUTH 23 /* Authorization denied */define SQLITE_ROW 100 /* sqlite_step() has another row ready */define SQLITE_DONE 101 /* sqlite_step() has finished executing */ 執(zhí)行 SQL 語句 typedef int (*sqlite_callback)(void*,int,char**, char**)。 int sqlite3_close(sqlite3*)。 總覽SQLite3是SQLite一個全新的版本,它雖然是在SQLite ,但是使用了和之前的版本不兼容的數(shù)據(jù)庫格式和API. SQLite3是為了滿足以下的需求而開發(fā)的:支持UTF16編碼.用戶自定義的文本排序方法.可以對BLOBs字段建立索引.因此為了支持這些特性我改變了數(shù)據(jù)庫的格式,. 至于其他的兼容性的改變,例如全新的API等等,都將在理論介紹之后向你說明,這樣可以使你最快的一次性擺脫兼容性問題.,但是有一些重要的改變需要注意. 所有API接口函數(shù)和數(shù)據(jù)結(jié)構(gòu)的前綴都由sqlite_改為了sqlite3_. 這是為了避免同時使用SQLite .由于對于C語言應(yīng)該用什么數(shù)據(jù)類型來存放UTF16編碼的字符串并沒有一致的規(guī)范. 因此SQLite使用了普通的void* 類型來指向UTF16編碼的字符串. 客戶端使用過程中可以把void*映射成適合他們的系統(tǒng)的任何數(shù)據(jù)類型. C/C++ 接口SQLite ,此外還有一些數(shù)據(jù)結(jié)構(gòu)和預(yù)定義(defines). (完整的API介紹請參看另一份文檔.) 不過你們可以放心,這些接口使用起來不會像它的數(shù)量所暗示的那么復(fù)雜. 最簡單的程序仍然使用三個函數(shù)就可以完成: sqlite3_open(), sqlite3_exec(), 和 sqlite3_close(). 要是想更好的控制數(shù)據(jù)庫引擎的執(zhí)行,可以使用提供的sqlite3_prepare()函數(shù)把SQL語句編譯成字節(jié)碼,然后在使用sqlite3_step()函數(shù)來執(zhí)行編譯后的字節(jié)碼. 以sqlite3_column_開頭的一組API函數(shù)用來獲取查詢結(jié)果集中的信息. 許多接口函數(shù)都是成對出現(xiàn)的,同時有UTF8和UTF16兩個版本. 并且提供了一組函數(shù)用來執(zhí)行用戶自定義的SQL函數(shù)和文本排序函數(shù). 如何打開關(guān)閉數(shù)據(jù)庫 typedef struct sqlite3 sqlite3。 const char *sqlite3_errmsg(sqlite3*)。 int sqlite3_exec(sqlite3*, const char *sql, sqlite_callback, void*, char**)。 int sqlite3_finalize(sqlite3_stmt*)。 int sqlite3_bind_int(sqlite3_stmt*, int, int)。 int sqlite3_bind_text16(sqlite3_stmt*, int, const void*, int n, void(*)(void*))。 int sqlite3_column_bytes(sqlite3_stmt*, int iCol)。 const void *sqlite3_column_decltype16(sqlite3_stmt *, int iCol)。 const char *sqlite3_column_name(sqlite3_stmt*, int iCol)。 int sqlite3_column_type(sqlite3_stmt*, int iCol)。 define SQLITE_UTF8 1 define SQLITE_UTF16 2 define SQLITE_UTF16BE 3 define SQLITE_UTF16LE 4 define SQLITE_ANY 5nArg 參數(shù)用來表明自定義函數(shù)的參數(shù)個數(shù). 如果參數(shù)值為0，則表示接受任意個數(shù)的參數(shù). 用 eTextRep 參數(shù)來表明傳入?yún)?shù)的編碼形式. 參數(shù)值可以是上面的五種預(yù)定義值. SQLite3 允許同一個自定義函數(shù)有多種不同的編碼參數(shù)的版本. 數(shù)據(jù)庫引擎會自動選擇轉(zhuǎn)換參數(shù)編碼個數(shù)最少的版本使用.普通的函數(shù)只需要設(shè)置 xFunc 參數(shù)，而把 xStep 和 xFinal 設(shè)為NULL. 聚合函數(shù)則需要設(shè)置 xStep 和 xFinal 參數(shù)，然后把 xFunc 設(shè)為NULL. 該方法和使用sqlite3_create_aggregate() API一樣.sqlite3_create_function16()和sqlite_create_function()的不同就在于自定義的函數(shù)名一個要求是 UTF16 編碼，而另一個則要求是 UTF8.請注意自定函數(shù)的參數(shù)目前使用了sqlite3_value結(jié)構(gòu)體指針替代了SQLite version . 下面的函數(shù)用來從sqlite3_value結(jié)構(gòu)體中提取數(shù)據(jù): const void *sqlite3_value_blob(sqlite3_value*)。 int sqlite3_value_int(sqlite3_value*)。 int sqlite3_value_type(sqlite3_value*)。 void sqlite3_result_double(sqlite3_context*, double)。 void sqlite3_result_int64(sqlite3_context*, long long int)。 void sqlite3_result_value(sqlite3_context*, sqlite3_value*)。 sqlite3_create_collation16(sqlite3*, const void *zName, int eTextRep, void*, int(*xCompare)(void