以下完整示範 iOS 中以原生 sqlite3 API 操作資料庫的各個環節,包含開啟、建表、插入與查詢。
#import <sqlite3.h>
@interface ViewController ()
{
sqlite3 *_sqldb;
}
@end
@implementation ViewController
- (void)viewDidLoad
{
[super viewDidLoad];
[self OpenDb];
[self createTable];
[self insertData];
[self FindData];
}
// 打開資料庫
- (void)OpenDb
{
NSArray *arrs = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES);
// 資料庫不存在時會建立,存在時直接打開
NSString *path = [arrs lastObject];
NSString *documentpath = [path stringByAppendingPathComponent:@"sql.db"];
int reslut = sqlite3_open([documentpath UTF8String], &_sqldb);
if (reslut == SQLITE_OK) {
NSLog(@"數據庫已被打開");
}
}
// 透過資料庫實例建表
- (void)createTable
{
// 不帶參數的 SQL
const char *sql = "create table if not exists t_person (id integer primary key autoincrement, name text, age integer);";
char *error;
// sqlite3_exec 可執行一切不帶參數的 SQL。
// 帶參數時盡量不要用,以免 SQL 注入
int resutl = sqlite3_exec(_sqldb, sql, NULL, NULL, &error);
if (resutl == SQLITE_OK) {
NSLog(@"創建表成功");
} else {
NSLog(@"創建表失敗--》%s", error);
}
}
// 插入資料
- (void)insertData
{
// "?" 是佔位符
const char *sql = "insert into t_person(name, age) values(?, ?);";
sqlite3_stmt *stmp;
// 執行前先檢查語法,-1 代表自動計算字串長度
int result = sqlite3_prepare_v2(_sqldb, sql, -1, &stmp, NULL);
if (result == SQLITE_OK) {
NSLog(@"插入 SQL 語法沒有問題");
// 綁定參數,注意下標從 1 開始
sqlite3_bind_text(stmp, 1, "gcb", -1, NULL);
sqlite3_bind_int(stmp, 2, 12);
// 執行帶參數的 SQL,不能用 exec
int stepResult = sqlite3_step(stmp);
// 插入結果用 SQLITE_DONE 判斷
if (stepResult == SQLITE_DONE) {
NSLog(@"插入成功");
} else {
NSLog(@"插入失敗");
}
sqlite3_finalize(stmp);
} else {
NSLog(@"插入 SQL 語法有問題");
}
}
// 查詢資料
- (void)FindData
{
char *sql = "select id, name, age from t_person";
sqlite3_stmt *stmt;
// 檢查語法
int result = sqlite3_prepare_v2(_sqldb, sql, -1, &stmt, NULL);
if (result == SQLITE_OK) {
// 查詢的欄位下標從 0 開始(綁定參數則從 1 開始)
while (sqlite3_step(stmt) == SQLITE_ROW) {
int xh = sqlite3_column_int(stmt, 0);
char *name = (char *)sqlite3_column_text(stmt, 1);
int age = sqlite3_column_int(stmt, 2);
NSLog(@"xh=%i-->name=%s-->age=%i", xh, name, age);
}
sqlite3_finalize(stmt);
} else {
NSLog(@"查詢 SQL 語法有誤");
}
}
@end
把上面這段程式拆開來看,有幾個規則一旦記住就不容易出錯:
sqlite3_exec 適合 CREATE、DROP、ALTER 這類沒有參數的敘述;sqlite3_prepare_v2 + sqlite3_bind_* + sqlite3_step 則用於帶參數或需要讀回結果的情境。SQLITE_ROW 判斷有沒有資料,寫入用 SQLITE_DONE 判斷是否成功,兩者不可混用。sqlite3_finalize,並在 App 生命週期合適時機以 sqlite3_close 關閉連線。以上就是 iOS 中原生 SQLite 的完整操作示範。