原文地址:http://marshal.easymorse.com/archives/3349
ios簡單sqlite使用
sqlite是嵌入式的和輕量級的sql數據庫。sqlite是由c實現的。廣泛用於包括瀏覽器(支持html5的大部分瀏覽器,ie除外)、ios、android以及一些便攜需求的小型web應用系統。
使用sqlite前的準備
使用sqlite是很多做ios開發中第一次面對c的情況,包括我。因爲sqlite是c寫的,objc可以直接使用c代碼。在sqlite前,一般都會使用cocoa touch框架,都是基於objc的。
首先,需要在對應文件的頭文件中加入:
#import "/usr/include/sqlite3.h"
並在Frameworks中加入所需的庫,否則會報錯:
Undefined symbols:
"_sqlite3_open", referenced from:
加入庫的方法是:
選擇sqlite庫libsqlite3.0.dylib:
選擇完的效果:
然後,添加成員變量sqlite3 *database,比如:
@interface DetailViewController : UIViewController <UIPopoverControllerDelegate, UISplitViewControllerDelegate> {
sqlite3 *database;}
打開數據庫
sqlite數據庫是文件數據庫,是保存在文件系統中的。因此需要知道文件保存到哪裏,可參見iOS中對文件的操作。比如本文保存到Documents目錄下。代碼:
NSArray *documentsPaths=NSSearchPathForDirectoriesInDomains(NSDocumentDirectory
, NSUserDomainMask
, YES);
NSString *databaseFilePath=[[documentsPaths objectAtIndex:0] stringByAppendingPathComponent:@"mydb"];if (sqlite3_open([databaseFilePath UTF8String], &database)==SQLITE_OK) {
NSLog(@"open sqlite db ok.");
}
通過ssh查看Documents目錄,發現mydb文件已經創建。sqlite的策略是如果有該文件就打開,如果沒有就創建文件,也就是創建數據庫。
這裏要注意,使用的是c語法,sqlite3_open傳入的是database的地址。
關閉數據庫
數據庫使用完畢後,要關閉,比如退出應用的時候:
- (void)viewDidUnload {
// Release any retained subviews of the main view.
// e.g. self.myOutlet = nil;
sqlite3_close(database);
self.popoverController = nil;
}
建表語句
數據庫打開以後,如果沒有表,建表:
char *errorMsg;
const char *createSql="create table if not exists persons (id integer primary key autoincrement,name text)";if (sqlite3_exec(database, createSql, NULL, NULL, &errorMsg)==SQLITE_OK) {
NSLog(@"create ok.");
}
這裏要特別注意errorMsg傳的是地址,因爲該函數要通過地址引用來寫報錯字符信息。
向表中插入記錄
和建表語句類似:
const char *insertSql="insert into persons (name) values(/"張三/")";
if (sqlite3_exec(database, insertSql, NULL, NULL, &errorMsg)==SQLITE_OK) {
NSLog(@"insert ok.");
}
錯誤信息的處理
如果在多個地方使用errorMsg,那麼每次使用完畢要清空一下字串,比如這樣:
if (sqlite3_exec(database, createSql, NULL, NULL, &errorMsg)==SQLITE_OK) {
NSLog(@"create ok.");
}else {
NSLog(@"error: %s",errorMsg);
sqlite3_free(errorMsg);
}
查詢結果集
結果集的查詢,需要用到statement:
const char *selectSql="select id,name from persons";
sqlite3_stmt *statement;
if (sqlite3_prepare_v2(database, selectSql, -1, &statement, nil)==SQLITE_OK) {
NSLog(@"select ok.");
}while (sqlite3_step(statement)==SQLITE_ROW) {
int _id=sqlite3_column_int(statement, 0);
char *name=(char *)sqlite3_column_text(statement, 1);
NSLog(@"row>>id %i, name %s",_id,name);
}sqlite3_finalize(statement);
不過這裏有個問題,看看打印的日誌:
亂碼。因爲直接用的char類型來做的。
解決辦法是,用nsstring替代char:
while (sqlite3_step(statement)==SQLITE_ROW) {
int _id=sqlite3_column_int(statement, 0);
NSString *name=[[NSString alloc] initWithCString:(char *)sqlite3_column_text(statement, 1) encoding:NSUTF8StringEncoding];
NSLog(@"row>>id %i, name %@",_id,name);
}
char生成nsstring的時候做一次顯式的編碼。問題解決:
這說明:
- 寫入數據庫,用char的方式沒有問題,寫入數據庫的編碼是對的;
- 從庫中取出,可能默認使用ascii解碼,造成顯示亂碼。
使用sqlite c api,要經常參考官方函數文檔:http://www.sqlite.org/c3ref/funclist.html