Sqlite 常用函數 推薦

來源:互聯網
上載者:User

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

編譯:
[root@localhost test]# gcc sql.c -o sql -l sqlite3

相關文章

A Free Trial That Lets You Build Big!

Start building with 50+ products and up to 12 months usage for Elastic Compute Service

  • Sales Support

    1 on 1 presale consultation

  • After-Sales Support

    24/7 Technical Support 6 Free Tickets per Quarter Faster Response

  • Alibaba Cloud offers highly flexible support services tailored to meet your exact needs.