Sqlite3 C語言 應用

1.打開數據庫連接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 可讓你學到很多東西）。

2。關閉數據庫連接sqlite3_close用法

原型：

int sqlite3_close(sqlite3 *ppDb);

 

ppDb爲剛纔使用sqlite3_open打開的數據庫連接

3.執行sql操做sqlite3_exec用法

原型：

1 int sqlite3_exec(
2   sqlite3* ppDb,                             /* An open database */
3   const char *sql,                           /* SQL to be evaluated */
4   int (*callback)(void*,int,char**,char**),  /* Callback function */
5   void *,                                    /* 1st argument to callback */
6   char **errmsg                              /* Error msg written here */
7 );

 

這就是執行一條sql 語句的函數。 第1個參數再也不說了，是前面open函數獲得的指針。說了是關鍵數據結構。 第2個參數constchar*sql是一條sql 語句，以\0結尾。 第3個參數sqlite3_callback 是回調，當exec這條語句執行以後，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 把數據查出來，得經過回調告訴你查出了什麼數據。

4.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是對應的，表示這個字段的字段名稱

實例：

1 #include <iostream>
 2 using namespace std;
 3 #include "sqlite/sqlite3.h"
 4 int callback(void*,int,char**,char**);
 5 int main()
 6 {
 7     sqlite3* db;
 8     int nResult = sqlite3_open("test.db",&db);
 9     if (nResult != SQLITE_OK)
10     {
11         cout<<"打開數據庫失敗："<<sqlite3_errmsg(db)<<endl;
12         return 0;
13     }
14     else
15     {
16         cout<<"數據庫打開成功"<<endl;
17     }
18 
19     char* errmsg;
20 
21     nResult = sqlite3_exec(db,"create table fuck(id integer primary key autoincrement,name varchar(100))",NULL,NULL,&errmsg);
22      if (nResult != SQLITE_OK)
23      {
24          sqlite3_close(db);
25          cout<<errmsg;
26          sqlite3_free(errmsg);
27         return 0;
28     }
29     string strSql;
30     strSql+="begin;\n";
31     for (int i=0;i<100;i++)
32     {
33         strSql+="insert into fuck values(null,'heh');\n";
34     }
35     strSql+="commit;";
36     //cout<<strSql<<endl;
37 
38     nResult = sqlite3_exec(db,strSql.c_str(),NULL,NULL,&errmsg);
39 
40     if (nResult != SQLITE_OK)
41     {
42         sqlite3_close(db);
43         cout<<errmsg<<endl;
44         sqlite3_free(errmsg);
45         return 0;
46     }
47 
48     strSql = "select * from fuck";
49     nResult = sqlite3_exec(db,strSql.c_str(),callback,NULL,&errmsg);
50       if (nResult != SQLITE_OK)
51     {
52         sqlite3_close(db);
53         cout<<errmsg<<endl;
54         sqlite3_free(errmsg);
55         return 0;
56     }
57 
58     sqlite3_close(db);
59     return 0;
60 }
61 
62 int callback(void* ,int nCount,char** pValue,char** pName)
63 {
64     string s;
65     for(int i=0;i<nCount;i++)
66     {
67         s+=pName[i];
68         s+=":";
69         s+=pValue[i];
70         s+="\n";
71     }
72     cout<<s<<endl;
73     return 0;
74 }

Sqlite3函數調用返回值列表

Result Codes

#define SQLITE_OK           0   /* Successful result */

/* beginning-of-error-codes */

#define SQLITE_ERROR        1   /* SQL error or missing database */

#define SQLITE_INTERNAL     2   /* 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 sqlite3_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   /* Unknown opcode in sqlite3_file_control() */

#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   /* Database is empty */

#define SQLITE_SCHEMA      17   /* The database schema changed */

#define SQLITE_TOOBIG      18   /* String or BLOB exceeds size limit */

#define SQLITE_CONSTRAINT  19   /* Abort due to constraint 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_FORMAT      24   /* Auxiliary database format error */

#define SQLITE_RANGE       25   /* 2nd parameter to sqlite3_bind out of range */

#define SQLITE_NOTADB      26   /* File opened that is not a database file */

#define SQLITE_ROW         100  /* sqlite3_step() has another row ready */

#define SQLITE_DONE        101  /* sqlite3_step() has finished executing */

/* end-of-error-codes */

 

Extended Result Codes

#define SQLITE_IOERR_READ              (SQLITE_IOERR | (1<<8))

#define SQLITE_IOERR_SHORT_READ        (SQLITE_IOERR | (2<<8))

#define SQLITE_IOERR_WRITE             (SQLITE_IOERR | (3<<8))

#define SQLITE_IOERR_FSYNC             (SQLITE_IOERR | (4<<8))

#define SQLITE_IOERR_DIR_FSYNC         (SQLITE_IOERR | (5<<8))

#define SQLITE_IOERR_TRUNCATE          (SQLITE_IOERR | (6<<8))

#define SQLITE_IOERR_FSTAT             (SQLITE_IOERR | (7<<8))

#define SQLITE_IOERR_UNLOCK            (SQLITE_IOERR | (8<<8))

#define SQLITE_IOERR_RDLOCK            (SQLITE_IOERR | (9<<8))

#define SQLITE_IOERR_DELETE            (SQLITE_IOERR | (10<<8))

#define SQLITE_IOERR_BLOCKED           (SQLITE_IOERR | (11<<8))

#define SQLITE_IOERR_NOMEM             (SQLITE_IOERR | (12<<8))

#define SQLITE_IOERR_ACCESS            (SQLITE_IOERR | (13<<8))

#define SQLITE_IOERR_CHECKRESERVEDLOCK (SQLITE_IOERR | (14<<8))

#define SQLITE_IOERR_LOCK              (SQLITE_IOERR | (15<<8))

#define SQLITE_IOERR_CLOSE             (SQLITE_IOERR | (16<<8))

#define SQLITE_IOERR_DIR_CLOSE         (SQLITE_IOERR | (17<<8))

#define SQLITE_IOERR_SHMOPEN           (SQLITE_IOERR | (18<<8))

#define SQLITE_IOERR_SHMSIZE           (SQLITE_IOERR | (19<<8))

#define SQLITE_IOERR_SHMLOCK           (SQLITE_IOERR | (20<<8))

#define SQLITE_IOERR_SHMMAP            (SQLITE_IOERR | (21<<8))

#define SQLITE_IOERR_SEEK              (SQLITE_IOERR | (22<<8))

#define SQLITE_LOCKED_SHAREDCACHE      (SQLITE_LOCKED |  (1<<8))

#define SQLITE_BUSY_RECOVERY           (SQLITE_BUSY   |  (1<<8))

#define SQLITE_CANTOPEN_NOTEMPDIR      (SQLITE_CANTOPEN | (1<<8))

#define SQLITE_CORRUPT_VTAB            (SQLITE_CORRUPT | (1<<8))

#define SQLITE_READONLY_RECOVERY       (SQLITE_READONLY | (1<<8))

#define SQLITE_READONLY_CANTLOCK       (SQLITE_READONLY | (2<<8))

 

 

Conflict resolution modes

#define SQLITE_ROLLBACK 1

/* #define SQLITE_IGNORE 2 // Also used by sqlite3_authorizer() callback */

#define SQLITE_FAIL     3

/* #define SQLITE_ABORT 4  // Also an error code */

#define SQLITE_REPLACE  5

These constants are returned by sqlite3_vtab_on_conflict() to inform a virtual table implementation what the ON CONFLICT mode is for the SQL statement being evaluated.