開啟資料庫連結sqlite3_open用法
原型:
int sqlite3_open( const char *filename, /* Database filename (UTF-8) */ sqlite3 **ppDb /* OUT: SQLite db handle */);
用這個函數開始資料庫操作。需要傳入兩個參數,一是資料庫檔案名,比如:E:/test.db。檔案名稱不需要一定存在,如果此檔案不存在,sqlite會自動建立它。如果它存在,就嘗試把它當資料庫檔案來開啟。二是sqlite3**,即前面提到的關鍵資料結構。這個結構底層細節如何,你不要管它。
函數傳回值表示操作是否正確,如果是SQLITE_OK則表示操作正常。相關的傳回值sqlite定義了一些宏。具體這些宏的含義可以參考sqlite3.h 檔案。裡面有詳細定義(順便說一下,sqlite3 的代碼注釋率自稱是非常高的,實際上也的確很高。只要你會看英文,sqlite 可以讓你學到不少東西)。
關閉資料庫連結sqlite3_close用法
原型:
int sqlite3_close(sqlite3 *ppDb);
ppDb為剛才使用sqlite3_open開啟的資料庫連結
執行sql操作sqlite3_exec用法
原型:
int sqlite3_exec( sqlite3* ppDb, /* An open database */ const char *sql, /* SQL to be evaluated */ int (*callback)(void*,int,char**,char**), /* Callback function */ void *, /* 1st argument to callback */ char **errmsg /* Error msg written here */);
這就是執行一條sql 語句的函數。
第1個參數不再說了,是前面open函數得到的指標。說了是關鍵資料結構。
第2個參數constchar*sql是一條sql 語句,以\0結尾。
第3個參數sqlite3_callback 是回調,當這條語句執行之後,sqlite3會去調用你提供的這個函數。
第4個參數void*是你所提供的指標,你可以傳遞任何一個指標參數到這裡,這個參數最終會傳到回呼函數裡面,如果不需要傳遞指標給回呼函數,可以填NULL。等下我們再看回呼函數的寫
法,以及這個參數的使用。
第5個參數char** errmsg 是錯誤資訊。注意是指標的指標。sqlite3裡面有很多固定的錯誤資訊。執行sqlite3_exec 之後,執行失敗時可以查閱這個指標(直接cout<<errmsg得到一串字串資訊,這串資訊告訴你錯在什麼地方。sqlite3_exec函數通過修改你傳入的指標的指標,把你提供的指標指向錯誤提示資訊,這樣sqlite3_exec函數外面就可以通過這個char*得到具體錯誤提示。
說明:通常,sqlite3_callback 和它後面的void*這兩個位置都可以填NULL。填NULL表示你不需要回調。比如你做insert 操作,做delete操作,就沒有必要使用回調。而當你做select 時,就要使用回調,因為sqlite3 把資料查出來,得通過回調告訴你查出了什麼資料。
exec 的回調
typedef int(*sqlite3_callback)(void*,int,char**,char**);
你的回呼函數必須定義成上面這個函數的類型。下面給個簡單的例子:
//sqlite3的回呼函數
//sqlite 每查到一條記錄,就調用一次這個回調
int LoadMyInfo(void* para,intn_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是對應的,表示這個欄位的欄位名稱
執行個體:
#include <iostream>using namespace std;#include "sqlite/sqlite3.h"int callback(void*,int,char**,char**);int main(){ sqlite3* db; int nResult = sqlite3_open("test.db",&db); if (nResult != SQLITE_OK) { cout<<"開啟資料庫失敗:"<<sqlite3_errmsg(db)<<endl; return 0; } else { cout<<"資料庫開啟成功"<<endl; } char* errmsg; nResult = sqlite3_exec(db,"create table fuck(id integer primary key autoincrement,name varchar(100))",NULL,NULL,&errmsg); if (nResult != SQLITE_OK) { sqlite3_close(db); cout<<errmsg; sqlite3_free(errmsg); return 0; } string strSql; strSql+="begin;\n"; for (int i=0;i<100;i++) { strSql+="insert into fuck values(null,'heh');\n"; } strSql+="commit;"; //cout<<strSql<<endl; nResult = sqlite3_exec(db,strSql.c_str(),NULL,NULL,&errmsg); if (nResult != SQLITE_OK) { sqlite3_close(db); cout<<errmsg<<endl; sqlite3_free(errmsg); return 0; } strSql = "select * from fuck"; nResult = sqlite3_exec(db,strSql.c_str(),callback,NULL,&errmsg); if (nResult != SQLITE_OK) { sqlite3_close(db); cout<<errmsg<<endl; sqlite3_free(errmsg); return 0; } sqlite3_close(db); return 0;}int callback(void* ,int nCount,char** pValue,char** pName){ string s; for(int i=0;i<nCount;i++) { s+=pName[i]; s+=":"; s+=pValue[i]; s+="\n"; } cout<<s<<endl; return 0;}
修改自 董淳光