ios簡單使用sqlite3

原文地址: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:

 

加入庫的方法是:

image 

 

選擇sqlite庫libsqlite3.0.dylib

image

選擇完的效果:

image

然後,添加成員變量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);

不過這裏有個問題,看看打印的日誌:

image

亂碼。因爲直接用的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的時候做一次顯式的編碼。問題解決:

image

這說明:

  • 寫入數據庫,用char的方式沒有問題,寫入數據庫的編碼是對的;
  • 從庫中取出,可能默認使用ascii解碼,造成顯示亂碼。

使用sqlite c api,要經常參考官方函數文檔:http://www.sqlite.org/c3ref/funclist.html

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