【转】SQLite3的各个函数(全)

首先，添加framework：libsqlite3.0.dylib

需要在对应文件的头文件中加入：

  #import "/usr/include/sqlite3.h"

并在Frameworks中加入所需的库，否则会报错：

  Undefined symbols:
  "_sqlite3_open", referenced from:

加入库的方法是：

image

选择sqlite库：

image

选择完的效果：

image

下面是代码：

  1. //sqlite    
  2.     [self openDataBase];   
  3.     //[self createTable];   
  4.     //[self insertTable];   
  5.     [self queryTable];   
  6.        
  7.        
  8.     [self deleteTable];   
  9.     [self queryTable];   

实现：

  1. //open database   
  2. - (void)openDataBase   
  3. {   
  4.     NSArray *documentsPaths=NSSearchPathForDirectoriesInDomains(NSDocumentDirectory   
  5.                                                                 , NSUserDomainMask    
  6.                                                                 , YES);    
  7.     NSString *databaseFilePath=[[documentsPaths objectAtIndex:0] stringByAppendingPathComponent:@"db.sql"];   
  8.        
  9.     if (sqlite3_open([databaseFilePath UTF8String], &database)==SQLITE_OK)    
  10.     {    
  11.         NSLog(@"open sqlite db ok.");    
  12.     }   
  13.     else    
  14.     {   
  15.         NSLog( @"can not open sqlite db " );   
  16.    
  17.         //close database   
  18.         sqlite3_close(database);    
  19.     }   
  20. }   
  21.    
  22. //create table   
  23. - (void)createTable   
  24. {   
  25.     char *errorMsg;   
  26.     const char *createSql="create table if not exists persons (id integer primary key autoincrement,name text)";   
  27.        
  28.     if (sqlite3_exec(database, createSql, NULL, NULL, &errorMsg)==SQLITE_OK)    
  29.     {    
  30.         NSLog(@"create ok.");    
  31.     }   
  32.     else    
  33.     {   
  34.         NSLog( @"can not create table" );   
  35.         [self ErrorReport:(NSString *)createSql];   
  36.     }   
  37. }   
  38.    
  39.    
  40. //insert table   
  41. - (void)insertTable   
  42. {   
  43.     char *errorMsg;   
  44.    
  45.     const char *insertSql="insert into persons (name) values ('田周辉')";    
  46.     if (sqlite3_exec(database, insertSql, NULL, NULL, &errorMsg)==SQLITE_OK)    
  47.     {    
  48.         NSLog(@"insert ok.");    
  49.     }   
  50.     else    
  51.     {   
  52.         NSLog( @"can not insert it to table" );   
  53.         [self ErrorReport: (NSString *)insertSql];   
  54.     }   
  55. }   
  56.    
  57.    
  58. //error    
  59. - (void)ErrorReport: (NSString *)item   
  60. {   
  61.     char *errorMsg;   
  62.        
  63.     if (sqlite3_exec(database, (const char *)item, NULL, NULL, &errorMsg)==SQLITE_OK)   
  64.     {    
  65.         NSLog(@"%@ ok.",item);    
  66.     }   
  67.     else    
  68.     {    
  69.         NSLog(@"error: %s",errorMsg);    
  70.         sqlite3_free(errorMsg);    
  71.     }   
  72. }   
  73.    
  74.    
  75. //query table   
  76. - (void)queryTable   
  77. {   
  78.     const char *selectSql="select id,name from persons";    
  79.     sqlite3_stmt *statement;    
  80.     if (sqlite3_prepare_v2(database, selectSql, -1, &statement, nil)==SQLITE_OK)   
  81.     {    
  82.         NSLog(@"select ok.");    
  83.         while (sqlite3_step(statement)==SQLITE_ROW)//SQLITE_OK SQLITE_ROW   
  84.         {    
  85.             int _id=sqlite3_column_int(statement, 0);    
  86.             NSString *name=[[NSString alloc] initWithCString:(char *)sqlite3_column_text(statement, 1) encoding:NSUTF8StringEncoding];    
  87.             NSLog(@"row>>id %i, name>> %@",_id,name);    
  88.         }   
  89.            
  90.     }   
  91.     else    
  92.     {   
  93.         //error   
  94.         [self ErrorReport: (NSString *)selectSql];   
  95.     }   
  96.        
  97.     sqlite3_finalize(statement);   
  98. }   
  99.    
  100. //delete table   
  101. - (void)deleteTable   
  102. {      
  103.     char *errorMsg;   
  104.     [self openDataBase];   
  105.        
  106.     const char *sql = "DELETE FROM persons where id=24";   
  107.     if (sqlite3_exec(database, sql, NULL, NULL, &errorMsg)==SQLITE_OK)    
  108.     {    
  109.         NSLog(@"delete ok.");    
  110.     }   
  111.     else    
  112.     {   
  113.         NSLog( @"can not delete it" );   
  114.         [self ErrorReport: (NSString *)sql];   
  115.     }   
  116.        
  117. }   

命令行：

  1. sqlite3 database  //创建数据库 
  2.               crate table tableFile(id smallint, file_name varchar(256), up_state smallint, file_size smallint); //创建一个表格 
  3.         insert into tableFile values(1, "200110101.rcu", 100, 4500);   //插入数据 
  4. 5 如何访问SQLite3数据库 
  5. sqlite3_open //打开数据库 
  6. sqlite3_prepare //将UTF－8格式的SQL语句转换为指向已备语句的指针 
  7. sqlite3_column_string //返回某一行的字符串 
  8. sqlite3_finalize //删除一条已备语句 
  9. sqlite3_close //关闭数据库 
  10.  
  11. 6 source code 
  12.  
  13. - (id)lookupSingularSQL:(NSString *)sql forType:(NSString *)rettype { 
  14.  
  15. sqlite3_stmt *statement; 
  16.  
  17. id result; 
  18.  
  19. if (statement = [self prepare:sql]) { 
  20.  
  21. if (sqlite3_step(statement) == SQLITE_ROW) { 
  22.  
  23. if ([rettype compare:@"text"] == NSOrderedSame) { 
  24.  
  25. char temp_buf[256]; 
  26.  
  27. memset(temp_buf, 0, 256); 
  28.  
  29. sprintf(temp_buf, "%s %s %s %s",  
  30.  
  31. (char *)sqlite3_column_text(statement,0), 
  32.  
  33. (char *)sqlite3_column_text(statement,1), 
  34.  
  35. (char *)sqlite3_column_text(statement,2), 
  36.  
  37. (char *)sqlite3_column_text(statement,3) 
  38.  
  39. ); 
  40.  
  41. result = [NSString stringWithUTF8String:temp_buf]; 
  42.  
  43. //result = [NSString stringWithUTF8String:(char *)sqlite3_column_text(statement,0)]; 
  44.  
  45. } else if ([rettype compare:@"integer"] == NSOrderedSame) { 
  46.  
  47. result = (id)sqlite3_column_int(statement,0); 
  48.  
  49.             } 
  50.  
  51. } 
  52.  
  53. } 
  54.  
  55. sqlite3_finalize(statement); 
  56.  
  57. return result; 
  58.  
  59. } 

应该有个成员变量，比如我的代码：

  1. @interface DetailViewController : UIViewController { 
  2. UIPopoverController *popoverController; 
  3. UIToolbar *toolbar; 
  4. id detailItem; 
  5. UILabel *detailDescriptionLabel; 
  6. sqlite3 *database; 

打开数据库

SQLite数据库是文件数据库，是保存在文件系统中的。因此需要知道文件保存到哪里，可参见iOS中对文件的操作。比如本文保存到Documents目录下。代码：

  1. NSArray *documentsPaths=NSSearchPathForDirectoriesInDomains(NSDocumentDirectory 
  2. , NSUserDomainMask 
  3. , YES); 
  4. NSString *databaseFilePath=[[documentsPaths objectAtIndex:0] stringByAppendingPathComponent:@"mydb"]; 
  5. if (sqlite3_open([databaseFilePath UTF8String], &database)==SQLITE_OK) { 
  6. NSLog(@"open sqlite db ok."); 
  7. } 

通过ssh查看Documents目录，发现mydb文件已经创建。sqlite的策略是如果有该文件就打开，如果没有就创建文件，也就是创建数据库。

这里要注意，使用的是C语法，sqlite3_open传入的是database的地址。

关闭数据库

数据库使用完毕后，要关闭，比如退出应用的时候：

  1. - (void)viewDidUnload { 
  2. // Release any retained subviews of the main view. 
  3. // e.g. self.myOutlet = nil; 
  4. sqlite3_close(database); 
  5. self.popoverController = nil; 
  6. } 

建表语句

数据库打开以后，如果没有表，建表：

  1. char *errorMsg; 
  2. const char *createSql="create table if not exists persons (id integer primary key autoincrement,name text)"; 
  3. if (sqlite3_exec(database, createSql, NULL, NULL, &errorMsg)==SQLITE_OK) { 
  4. NSLog(@"create ok."); 
  5. } 

这里要特别注意errorMsg传的是地址，因为该函数要通过地址引用来写报错字符信息。

向表中插入记录

和建表语句类似：

  1. const char *insertSql="insert into persons (name) values(‘张三’)"; 
  2. if (sqlite3_exec(database, insertSql, NULL, NULL, &errorMsg)==SQLITE_OK) { 
  3. NSLog(@"insert ok."); 
  4. } 

错误信息的处理

如果在多个地方使用errorMsg，那么每次使用完毕要清空一下字串，比如这样：

  1. if (sqlite3_exec(database, createSql, NULL, NULL, &errorMsg)==SQLITE_OK) { 
  2. NSLog(@"create ok."); 
  3. }else { 
  4. NSLog(@"error: %s",errorMsg); 
  5. sqlite3_free(errorMsg); 
  6. } 

查询结果集

结果集的查询，需要用到statement：

  1. const char *selectSql="select id,name from persons"; 
  2. sqlite3_stmt *statement; 
  3. if (sqlite3_prepare_v2(database, selectSql, -1, &statement, nil)==SQLITE_OK) { 
  4. NSLog(@"select ok."); 
  5. } 
  6. while (sqlite3_step(statement)==SQLITE_ROW) { 
  7. int _id=sqlite3_column_int(statement, 0); 
  8. char *name=(char *)sqlite3_column_text(statement, 1); 
  9. NSLog(@"row>>id %i, name %s",_id,name); 
  10. } 
  11. sqlite3_finalize(statement); 

不过这里有个问题，看看打印的日志：

image

乱码。因为直接用的char类型来做的。

解决办法是，用nsstring替代char：

  1. while (sqlite3_step(statement)==SQLITE_ROW) { 
  2. int _id=sqlite3_column_int(statement, 0); 
  3. NSString *name=[[NSString alloc] initWithCString:(char *)sqlite3_column_text(statement, 1) encoding:NSUTF8StringEncoding]; 
  4. NSLog(@"row>>id %i, name %@",_id,name); 
  5. } 

char生成nsstring的时候做一次显式的编码。问题解决：

image

这说明：

写入数据库，用char的方式没有问题，写入数据库的编码是对的;

从库中取出，可能默认使用ascii解码，造成显示乱码。

使用sqlite c api，要经常参考官方函数文档：http://www.sqlite.org/c3ref/funclist.html

posted @ 2012-03-27 17:02  编程小翁  阅读(9576)  评论(1)  编辑  收藏  举报
我是来自厦门的Jilon. 翁，请关注我的微博：真实的weng，或关注微信：Jilon