Sqlite 常用函數推薦

2020-01-31 15:12:48

字體：大中小

來源：轉載

供稿：網友

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

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

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

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

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

7 、釋放查詢結果：
功能：釋放當前查詢的記錄集所占用的內存
void sqlite3_free_table(char **result);

實例：（ SQLite 數據庫使用回調函數的簡單 C 語言實例）

復制代碼代碼如下:

 
#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; 
} 