一、简单说明
在iOS中使用SQLite3,首先要添加库文件libsqlite3.dylib和导入主头文件。
导入头文件,可以使用库中的函数(是纯C语言的)
二、具体说明
新建一个项目,在项目的主界面中放四个按钮(分别是,增加、删除、修改、查询)。
1.sqlite3_open(<#const char *filename#>, <#sqlite3 **ppDb#>)函数的一些说明:
(1)作用:把一个文件名称传递给他,它会自动检测这个文件是否存在,如果不存在的话,会自动创建相应的文件(这里为数据库文件,刚创建为空)。
(2)参数:它的第一个参数为文件的名称(需转换为C语言的),第二个参数是数据库的实例,sqlite3 *db;
说明:sqlite3是一种类型,db是数据库的句柄,就是数据库的象征,如果要进行增删改查,就得操作db这个实例。
(3)返回值:它的返回值为int型的,根据函数的返回值可以知道,打开数据库文件是成功还是失败,如果返回值是SQLITE_OK则说明成功,否则为失败。
2.打开数据库
实现代码和显示:
查看沙盒内创建的数据库文件:
双击打开,查看发现打开的数据库连接名称为students,默认为文件名的前缀,数据库创建成功。
3.创建表
函数说明:
参数:第一个参数为数据库的句柄(db),第二个参数为sql语句,第三个参数为回调参数,是一个指向函数的指针,如果把callback前面的*改成^则就是一个block代码段,第四个参数可以写NULL,第五个参数为错误信息,用以代码调试。
1 //1.打开数据库文件(如果数据库文件不存在,那么该函数会自动创建数据库文件) 2 int result = sqlite3_open(cfileName, &db); 3 if (result==SQLITE_OK) { //打开成功 4 NSLog(@"成功打开数据库"); 5 6 //2.创建表 7 const char *sql="CREATE TABLE IF NOT EXISTS t_students (id integer PRIMARY KEY AUTOINCREMENT,name text NOT NULL,age integer NOT NULL);"; 8 char *errmsg=NULL; 9 result = sqlite3_exec(db, sql, NULL, NULL, &errmsg); 10 if (result==SQLITE_OK) { 11 NSLog(@"创表成功"); 12 }else 13 { 14 NSLog(@"创表失败----%s",errmsg); 15 } 16 }else 17 { 18 NSLog(@"打开数据库失败"); 19 }
执行后,创表成功,打开创建的表查看:
调试技巧:
1 if (result==SQLITE_OK) { 2 NSLog(@"创表成功"); 3 }else 4 { 5 // NSLog(@"创表失败----%s",errmsg); 6 printf("创表失败---%s----%s---%d",errmsg,__FILE__,__LINE__); 7 }
__FILE__宏打印文件名,
__LINE__宏打印行号。
4.插入数据
实现代码:
1 - (IBAction)insert { 2 for (int i=0; i<20; i++) { 3 //1.拼接SQL语句 4 NSString *name=[NSString stringWithFormat:@"文晓--%d",arc4random_uniform(100)]; 5 int age=arc4random_uniform(20)+10; 6 NSString *sql=[NSString stringWithFormat:@"INSERT INTO t_students (name,age) VALUES ('%@',%d);",name,age]; 7 8 //2.执行SQL语句 9 char *errmsg=NULL; 10 sqlite3_exec(self.db, sql.UTF8String, NULL, NULL, &errmsg); 11 if (errmsg) {//如果有错误信息 12 NSLog(@"插入数据失败--%s",errmsg); 13 }else 14 { 15 NSLog(@"插入数据成功"); 16 } 17 } 18 }
打印查看:
查看数据库里t_students表中的数据:
5.选择(select)查询操作
函数说明:
select操作也可以使用sqlite3_exec函数实现,但通常使用下面的函数。
参数:第一个参数为数据库的句柄,第二个参数为sql语句,第三个参数为sql的长度(如果设置为-1,则代表系统会自动计算sql语句的长度),第四个参数用来取数据,第五个参数为尾部一般用不上可直接写NULL。
示例代码:
1 - (IBAction)select { 2 const char *sql="SELECT id,name,age FROM t_students WHERE age<20;"; 3 sqlite3_stmt *stmt=NULL; 4 5 //进行查询前的准备工作 6 if (sqlite3_prepare_v2(self.db, sql, -1, &stmt, NULL)==SQLITE_OK) {//SQL语句没有问题 7 NSLog(@"查询语句没有问题"); 8 9 //每调用一次sqlite3_step函数,stmt就会指向下一条记录 10 while (sqlite3_step(stmt)==SQLITE_ROW) {//找到一条记录 11 //取出数据 12 //(1)取出第0列字段的值(int类型的值) 13 int ID=sqlite3_column_int(stmt, 0); 14 //(2)取出第1列字段的值(text类型的值) 15 const unsigned char *name=sqlite3_column_text(stmt, 1); 16 //(3)取出第2列字段的值(int类型的值) 17 int age=sqlite3_column_int(stmt, 2); 18 // NSLog(@"%d %s %d",ID,name,age); 19 printf("%d %s %d ",ID,name,age); 20 } 21 }else 22 { 23 NSLog(@"查询语句有问题"); 24 } 25 26 }
打印查看查询结果:
三、补充
完整代码:
YYViewController.m文件
1 // 2 // YYViewController.m 3 // 02-SQLite的应用 4 // 5 6 #import "YYViewController.h" 7 #import <sqlite3.h> 8 9 @interface YYViewController () 10 //db是数据库的句柄,就是数据库的象征,要对数据库进行增删改查,就得操作这个实例 11 @property(nonatomic,assign)sqlite3 *db; 12 - (IBAction)insert; 13 - (IBAction)delete; 14 - (IBAction)update; 15 - (IBAction)select; 16 17 @end 18 19 @implementation YYViewController 20 21 - (void)viewDidLoad 22 { 23 [super viewDidLoad]; 24 25 // sqlite3 *db; 26 27 //获得数据库文件的路径 28 NSString *doc=[NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES) lastObject]; 29 NSString *fileName=[doc stringByAppendingPathComponent:@"students.sqlite"]; 30 //将OC字符串转换为c语言的字符串 31 const char *cfileName=fileName.UTF8String; 32 33 //1.打开数据库文件(如果数据库文件不存在,那么该函数会自动创建数据库文件) 34 int result = sqlite3_open(cfileName, &_db); 35 if (result==SQLITE_OK) { //打开成功 36 NSLog(@"成功打开数据库"); 37 38 //2.创建表 39 const char *sql="CREATE TABLE t_students (id integer PRIMARY KEY AUTOINCREMENT,name text NOT NULL,age integer NOT NULL);"; 40 char *errmsg=NULL; 41 result = sqlite3_exec(self.db, sql, NULL, NULL, &errmsg); 42 if (result==SQLITE_OK) { 43 NSLog(@"创表成功"); 44 }else 45 { 46 // NSLog(@"创表失败----%s",errmsg); 47 printf("创表失败---%s----%s---%d",errmsg,__FILE__,__LINE__); 48 } 49 }else 50 { 51 NSLog(@"打开数据库失败"); 52 } 53 } 54 55 - (IBAction)insert { 56 for (int i=0; i<20; i++) { 57 //1.拼接SQL语句 58 NSString *name=[NSString stringWithFormat:@"文晓--%d",arc4random_uniform(100)]; 59 int age=arc4random_uniform(20)+10; 60 NSString *sql=[NSString stringWithFormat:@"INSERT INTO t_students (name,age) VALUES ('%@',%d);",name,age]; 61 62 //2.执行SQL语句 63 char *errmsg=NULL; 64 sqlite3_exec(self.db, sql.UTF8String, NULL, NULL, &errmsg); 65 if (errmsg) {//如果有错误信息 66 NSLog(@"插入数据失败--%s",errmsg); 67 }else 68 { 69 NSLog(@"插入数据成功"); 70 } 71 } 72 } 73 74 - (IBAction)delete { 75 } 76 77 - (IBAction)updata { 78 } 79 80 - (IBAction)select { 81 const char *sql="SELECT id,name,age FROM t_students WHERE age<20;"; 82 sqlite3_stmt *stmt=NULL; 83 84 //进行查询前的准备工作 85 if (sqlite3_prepare_v2(self.db, sql, -1, &stmt, NULL)==SQLITE_OK) {//SQL语句没有问题 86 NSLog(@"查询语句没有问题"); 87 88 //每调用一次sqlite3_step函数,stmt就会指向下一条记录 89 while (sqlite3_step(stmt)==SQLITE_ROW) {//找到一条记录 90 //取出数据 91 //(1)取出第0列字段的值(int类型的值) 92 int ID=sqlite3_column_int(stmt, 0); 93 //(2)取出第1列字段的值(text类型的值) 94 const unsigned char *name=sqlite3_column_text(stmt, 1); 95 //(3)取出第2列字段的值(int类型的值) 96 int age=sqlite3_column_int(stmt, 2); 97 // NSLog(@"%d %s %d",ID,name,age); 98 printf("%d %s %d ",ID,name,age); 99 } 100 }else 101 { 102 NSLog(@"查询语句有问题"); 103 } 104 105 } 106 @end