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-1")
選擇sqlite庫：
![]( "sqlite-2")
選擇完的效果：
![]( "sqlite-3")
然後，應該有個成員變量，比如我的代碼：
1
2
3
4
5
6
|
@interface DetailViewController : UIViewController <UIPopoverControllerDelegate, UISplitViewControllerDelegate> {
UIPopoverController *popoverController;
UIToolbar *toolbar;
id detailItem;
UILabel *detailDescriptionLabel;
sqlite3 *database;
|
打開數據庫
sqlite數據庫是文件數據庫，是保存在文件系統中的。因此需要知道文件保存到哪裏，可參見iOS中對文件的操作。比如本文保存到Documents目錄下。代碼：
1
2
3
4
5
6
7
8
|
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的地址。
關閉數據庫
數據庫使用完畢後，要關閉，比如退出應用的時候：
1
2
3
4
5
6
|
- (void)viewDidUnload {
// Release any retained subviews of the main view.
// e.g. self.myOutlet = nil;
sqlite3_close(database);
self.popoverController = nil;
}
|
建表語句
數據庫打開以後，如果沒有表，建表：
1
2
3
4
5
6
|
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傳的是地址，因爲該函數要通過地址引用來寫報錯字符信息。
向表中插入記錄
和建表語句類似：
1
2
3
4
|
const char *insertSql="insert into persons (name) values(‘張三’)";
if (sqlite3_exec(database, insertSql, NULL, NULL, &errorMsg)==SQLITE_OK) {
NSLog(@"insert ok.");
}
|
錯誤信息的處理
如果在多個地方使用errorMsg，那麼每次使用完畢要清空一下字串，比如這樣：
1
2
3
4
5
6
|
if (sqlite3_exec(database, createSql, NULL, NULL, &errorMsg)==SQLITE_OK) {
NSLog(@"create ok.");
}else {
NSLog(@"error: %s",errorMsg);
sqlite3_free(errorMsg);
}
|
查詢結果集
結果集的查詢，需要用到statement：
1
2
3
4
5
6
7
8
9
10
11
12
13
|
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);
|
不過這裏有個問題，看看打印的日誌：
![]( "sqlite-4")
亂碼。因爲直接用的char類型來做的。
解決辦法是，用nsstring替代char：
1
2
3
4
5
|
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的時候做一次顯式的編碼。問題解決：
![]( "sqlite-5")
這說明：
* 寫入數據庫，用char的方式沒有問題，寫入數據庫的編碼是對的；
* 從庫中取出，可能默認使用ascii解碼，造成顯示亂碼。
使用sqlite c api，要經常參考官方函數文檔：http://www.sqlite.org/c3ref/funclist.html
原文鏈接：http://marshal.easymorse.com/archives/3349
