IOS學習之數據庫(6)--SQLite常用的函數

轉載自 http://www.cnblogs.com/wendingding/p/3871792.html


一、簡單說明

1.打開數據庫

int sqlite3_open(

    const char *filename,   // 數據庫的文件路徑

    sqlite3 **ppDb          // 數據庫實例

);

 

2.執行任何SQL語句

int sqlite3_exec(

    sqlite3*,                                  // 一個打開的數據庫實例

    const char *sql,                           // 需要執行的SQL語句

    int (*callback)(void*,int,char**,char**),  // SQL語句執行完畢後的回調

    void *,                                    // 回調函數的第1個參數

    char **errmsg                              // 錯誤信息

);

 

3.檢查SQL語句的合法性(查詢前的準備)

int sqlite3_prepare_v2(

    sqlite3 *db,            // 數據庫實例

    const char *zSql,       // 需要檢查的SQL語句

    int nByte,              // SQL語句的最大字節長度

    sqlite3_stmt **ppStmt,  // sqlite3_stmt實例,用來獲得數據庫數據

    const char **pzTail

);

 

4.查詢一行數據

int sqlite3_step(sqlite3_stmt*); // 如果查詢到一行數據,就會返回SQLITE_ROW

 

5.利用stmt獲得某一字段的值(字段的下標從0開始)

double sqlite3_column_double(sqlite3_stmt*, int iCol);  // 浮點數據

int sqlite3_column_int(sqlite3_stmt*, int iCol); // 整型數據

sqlite3_int64 sqlite3_column_int64(sqlite3_stmt*, int iCol); // 長整型數據

const void *sqlite3_column_blob(sqlite3_stmt*, int iCol); // 二進制文本數據

const unsigned char *sqlite3_column_text(sqlite3_stmt*, int iCol);  // 字符串數據

 

二、SQLite編碼

1.創建、打開、關閉數據庫

創建或打開數據庫

// path是數據庫文件的存放路徑

sqlite3 *db = NULL;

int result = sqlite3_open([path UTF8String], &db); 

 

代碼解析:

sqlite3_open()將根據文件路徑打開數據庫,如果不存在,則會創建一個新的數據庫。如果result等於常量SQLITE_OK,則表示成功打開數據庫

sqlite3 *db:一個打開的數據庫實例

數據庫文件的路徑必須以C字符串(而非NSString)傳入

 

關閉數據庫:sqlite3_close(db);

 

2.執行不返回數據的SQL語句

執行創表語句

char *errorMsg = NULL;  // 用來存儲錯誤信息

char *sql = "create table if not exists t_person(id integer primary key autoincrement, name text, age integer);";

int result = sqlite3_exec(db, sql, NULL, NULL, &errorMsg);

 

代碼解析:

sqlite3_exec()可以執行任何SQL語句,比如創表、更新、插入和刪除操作。但是一般不用它執行查詢語句,因爲它不會返回查詢到的數據

sqlite3_exec()還可以執行的語句:

(1)開啓事務:begin transaction;

(2)回滾事務:rollback;

(3)提交事務:commit;

 

3.帶佔位符插入數據

char *sql = "insert into t_person(name, age) values(?, ?);";

sqlite3_stmt *stmt;

if (sqlite3_prepare_v2(db, sql, -1, &stmt, NULL) == SQLITE_OK) {

    sqlite3_bind_text(stmt, 1, "母雞", -1, NULL);

    sqlite3_bind_int(stmt, 2, 27);

}

if (sqlite3_step(stmt) != SQLITE_DONE) {

    NSLog(@"插入數據錯誤");

}

sqlite3_finalize(stmt);

 

代碼解析:

sqlite3_prepare_v2()返回值等於SQLITE_OK,說明SQL語句已經準備成功,沒有語法問題

sqlite3_bind_text():大部分綁定函數都只有3個參數

(1)第1個參數是sqlite3_stmt *類型

(2)第2個參數指佔位符的位置,第一個佔位符的位置是1,不是0

(3)第3個參數指佔位符要綁定的值

(4)第4個參數指在第3個參數中所傳遞數據的長度,對於C字符串,可以傳遞-1代替字符串的長度

(5)第5個參數是一個可選的函數回調,一般用於在語句執行後完成內存清理工作

sqlite_step():執行SQL語句,返回SQLITE_DONE代表成功執行完畢

sqlite_finalize():銷燬sqlite3_stmt *對象

 

4.查詢數據

char *sql = "select id,name,age from t_person;";

sqlite3_stmt *stmt;

if (sqlite3_prepare_v2(db, sql, -1, &stmt, NULL) == SQLITE_OK) {

    while (sqlite3_step(stmt) == SQLITE_ROW) {

        int _id = sqlite3_column_int(stmt, 0);

        char *_name = (char *)sqlite3_column_text(stmt, 1);

        NSString *name = [NSString stringWithUTF8String:_name];

        int _age = sqlite3_column_int(stmt, 2);

        NSLog(@"id=%i, name=%@, age=%i", _id, name, _age);

    }

}

sqlite3_finalize(stmt);

代碼解析:

sqlite3_step()返回SQLITE_ROW代表遍歷到一條新記錄

sqlite3_column_*()用於獲取每個字段對應的值,第2個參數是字段的索引,從0開始


發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章