iOS數據持久化—SQLite經常使用的函數

iOS開發數據庫篇—SQLite經常使用的函數

1、簡單說明

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);  // 字符串數據

 

2、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開始