SQLite常用函數

Sqlite常用函數：

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語言執行個體）

1.       #include <stdio.h>

2.        

3.       #include <sqlite3.h>

4.        

5.        

6.        

7.       static int callback(void *NotUsed, int argc, char **argv, char **azColName)

8.        

9.       {

10.    

11.     int i;

12.    

13.     for(i=0; i<argc; i++)

14.    

15.     {

16.    

17.       printf("%s = %s\n", azColName[i], argv[i] ? argv[i] : "NULL");

18.    

19.     }

20.    

21.     printf("\n");

22.    

23.     return 0;

24.    

25.   }

26.    

27.    

28.    

29.   int main(int argc, char **argv)

30.    

31.   {

32.    

33.     sqlite3 *db;

34.    

35.     char *zErrMsg = 0;

36.    

37.     int rc;

38.    

39.    

40.    

41.     if( argc!=3 )

42.    

43.     {

44.    

45.       fprintf(stderr, "Usage: %s DATABASE SQL-STATEMENT\n", argv[0]);

46.    

47.       return 1;

48.    

49.     }

50.    

51.     rc = sqlite3_open(argv[1], &db);

52.    

53.     if( rc )

54.    

55.     {

56.    

57.       fprintf(stderr, "Can't open database: %s\n", sqlite3_errmsg(db));

58.    

59.       sqlite3_close(db);

60.    

61.       return 1;

62.    

63.     }

64.    

65.     rc = sqlite3_exec(db, argv[2], callback, 0, &zErrMsg);

66.    

67.     if( rc!=SQLITE_OK )

68.    

69.     {

70.    

71.       fprintf(stderr, "SQL error: %s\n", zErrMsg);

72.    

73.       sqlite3_close(db);

74.    

75.       return 1;

76.    

77.     }

78.    

79.     sqlite3_close(db);

80.    

81.     return 0;

82.    

83.   }