Sqlite 常用函數(shù) 推薦

2020-01-31 15:12:48

字體：大中小

供稿：網(wǎng)友

1 、打開數(shù)據(jù)庫：
說明：打開一個數(shù)據(jù)庫，文件名不一定要存在，如果此文件不存在， sqlite 會自動創(chuàng)建。第一個參數(shù)指文件名，第二個參數(shù)則是定義的 sqlite3 ** 結(jié)構(gòu)體指針（關(guān)鍵數(shù)據(jù)結(jié)構(gòu)），這個結(jié)構(gòu)底層細(xì)節(jié)如何，您不用管它。
int sqlite3_open(
const char *filename, /* Database filename (UTF-8) */
sqlite3 **ppDb /* OUT: SQLite db handle */
);
返回值：表示操所是否正確（ SQLITE_OK 操作正常）

2 、關(guān)閉數(shù)據(jù)庫：
說明：如果用 sqlite3_open 開啟了一個數(shù)據(jù)庫，結(jié)尾時不要忘了用這個函數(shù)關(guān)閉數(shù)據(jù)庫。
int sqlite3_close(sqlite3*); // 參數(shù)就是剛才的結(jié)構(gòu)體，也就是數(shù)據(jù)庫句柄

3 、執(zhí)行 SQL 語句：
說明：這個函數(shù)的功能是執(zhí)行一條或者多條 SQL 語句， SQL 語句之間用 “;” 號隔開。建議在執(zhí)行一條或者多條 SQL 語句得時候，指定第三個參數(shù)回調(diào)函數(shù)，在回調(diào)函數(shù)中可以獲得執(zhí)行 Sql 得詳細(xì)過程，如果所有 Sql 執(zhí)行完畢則應(yīng)該返回 0 ，否則，則說明這次執(zhí)行并沒有完全成功。第五個參數(shù)：如果執(zhí)行失?。]有返回 0 ）則可以查看第五個闡述得值。來查看詳細(xì)錯誤信息。
int sqlite3_exec(
sqlite3*, /* 已經(jīng)打開的數(shù)據(jù)庫句柄 */
const char *sql, /* 要執(zhí)行的 Sql 語句 */
sqlite_callback, /* 回調(diào)函數(shù) */
void *, /* 傳遞給回調(diào)函數(shù)的參數(shù) */
char **errmsg /* 保存錯誤信息 */
);
通常 sqlite3_callback 和它后面的 void* 這兩個位置都可以填 NULL ，表示不需要回調(diào)。比如您做 insert 操作，做 delete 操作，就沒有必要使用回調(diào)。而當(dāng)作 select 時，就要使用回調(diào)，因為 sqlite3 把數(shù)據(jù)查出來，得通過回調(diào)告訴你查出了什么數(shù)據(jù)。

4 、 exec 的回調(diào)
typedef int (*sqlite3_callback)(void*, int, char**, char**);
說明：你的回調(diào)函數(shù)必須定義為上面這個函數(shù)的類型。
例如：
int LoadMyInfo( void * para, int n_column, char ** column_value, char ** column_name )
{
//para 是你在 sqlite3_exec 里傳入的 void * 參數(shù)
// 通過 para 參數(shù)，你可以傳入一些特殊的指針（比如類指針、結(jié)構(gòu)指針），然后在這里面強制轉(zhuǎn)換成對應(yīng)的類型（這里面是 void* 類型，必須強制轉(zhuǎn)換成你的類型才可用）。然后操作這些數(shù)據(jù)
//n_column 是這一條記錄有多少個字段 ( 即這條記錄有多少列 )
// char ** column_value 是個關(guān)鍵值，查出來的數(shù)據(jù)都保存在這里，它實際上是個 1 維數(shù)組（不要以為是 2 維數(shù)組），每一個元素都是一個 char * 值，是一個字段內(nèi)容（用字符串來表示，以 /0 結(jié)尾）
//char ** column_name 跟 column_value 是對應(yīng)的，表示這個字段的字段名稱

5 、取當(dāng)前插入位置：
功能：返回你前一次插入得位置，從 1 開始， sqlite3* 為你打開數(shù)據(jù)庫所得到得句柄。
long long int sqlite3_last_insert_rowid(sqlite3*);
6 、非回調(diào) select 查詢：
功能：執(zhí)行一次查詢 Sql 并且返回得到一個記錄集。
int sqlite3_get_table(
sqlite3*, /* 已經(jīng)打開的數(shù)據(jù)庫句柄 */
const char *sql, /* 要執(zhí)行的 Sql 語句 */
char ***resultp, /* 保存返回記錄集的指針 */
int *nrow, /* 返回記錄數(shù)（及查出多少行） */
int *ncolumn, /* 返回字段數(shù)（多少列） */
char **errmsg /* 返回錯誤信息 */
)
說明：第三個參數(shù)是查詢結(jié)果，它是一維數(shù)組，內(nèi)存布局為：第一行是字段名稱，后面是緊接著是每個字段的值。
實例：
int main( int , char ** )
{
sqlite3 * db;
int result;
char * errmsg = NULL;
char **dbResult;
int nRow, nColumn;
int i , j;
int index;
result = sqlite3_open( “c://Dcg_database.db”, &db );
if( result != SQLITE_OK )
{
return -1;
}
// 數(shù)據(jù)庫操作代碼
// 假設(shè)前面已經(jīng)創(chuàng)建了 MyTable_1 表
// 開始查詢，傳入的 dbResult 已經(jīng)是 char ** ，這里又加了一個 & 取地址符，傳遞進去的就成了 char ***
result = sqlite3_get_table( db, “select * from MyTable_1”, &dbResult, &nRow, &nColumn, &errmsg );
if( SQLITE_OK == result )
{
// 查詢成功
index = nColumn; // 前面說過 dbResult 前面第一行數(shù)據(jù)是字段名稱，從 nColumn 索引開始才是真正的數(shù)據(jù)
printf( “ 查到 %d 條記錄 /n”, nRow );
for( i = 0; i < nRow ; i++ )
{
printf( “ 第 %d 條記錄 /n”, i+1 );
for( j = 0 ; j < nColumn; j++ )
{
printf( “ 字段名 :%s ?> 字段值 :%s/n”, dbResult[j], dbResult [index] );
++index; // dbResult 的字段值是連續(xù)的，從第 0 索引到第 nColumn - 1 索引都是字段名稱，從第 nColumn 索引開始，后面都是字段值，它把一個二維的表（傳統(tǒng)的行列表示法）用一個扁平的形式來表示
}
printf( “-------/n” );
}
}
// 到這里，不論數(shù)據(jù)庫查詢是否成功，都釋放 char** 查詢結(jié)果，使用 sqlite 提供的功能來釋放
sqlite3_free_table( dbResult );
// 關(guān)閉數(shù)據(jù)庫
sqlite3_close( db );
return 0;
}

7 、釋放查詢結(jié)果：
功能：釋放當(dāng)前查詢的記錄集所占用的內(nèi)存
void sqlite3_free_table(char **result);

實例：（ SQLite 數(shù)據(jù)庫使用回調(diào)函數(shù)的簡單 C 語言實例）

復(fù)制代碼代碼如下:

 
#include <stdio.h> 
#include <sqlite3.h> 
static int callback( void *NotUsed, int argc, char **argv, char **azColName) 
{ 
int i; 
for (i=0; i<argc; i++) 
{ 
printf( "%s = %s/n" , azColName[i], argv[i] ? argv[i] : "NULL" ); 
} 
printf( "/n" ); 
return 0; 
} 
int main( int argc, char **argv) 
{ 
sqlite3 *db; 
char *zErrMsg = 0; 
int rc; 
if ( argc!=3 ) 
{ 
fprintf(stderr, "Usage: %s DATABASE SQL-STATEMENT/n" , argv[0]); 
return 1; 
} 
rc = sqlite3_open(argv[1], &db); 
if ( rc ) 
{ 
fprintf(stderr, "Can't open database: %s/n" , sqlite3_errmsg(db)); 
sqlite3_close(db); 
return 1; 
} 
rc = sqlite3_exec(db, argv[2], callback, 0, &zErrMsg); 
if ( rc!=SQLITE_OK ) 
{ 
fprintf(stderr, "SQL error: %s/n" , zErrMsg); 
sqlite3_close(db); 
return 1; 
} 
sqlite3_close(db); 
return 0; 
} 