Sqlite是一个轻量级的数据库引擎,大概几百K左右,所以在嵌入式设备中应用广泛;而且由于接口简单,使其在非嵌入式领域中也被大量使用; 详细内容请参考官方介绍:http://www.sqlite.org/about.html,这里就不再赘述;
一、工程中引入sqlite3
数据库创建前需要在程序中引入sqlite3库文件以及在代码中添加sqlite3头文件;以XCode开发环境为例,需要在“Target->Build->Other Linker Flags”中加入“-lsqlite3”链接选项;记得代码文件中加入#import
二、数据库创建
数据库创建类似文件创建,使用sqlite3_open()函数,如果不存在就创建,如果存在就打开;
sqlite3 *db = NULL; int rc; char * dbPath = "myTest.db3"; rc = sqlite3_open(dbPath, &db); if(rc) { printf("Open database failed!"); sqlite3_close(db); return 1; }
使用sqlite3创建的数据库文件名称以db3作为文件类型并非必需,而是和sqlite文件有个区别;数据文件首次创建后,还需要创建表;代码如下:
//create or open Table char *sql = " CREATE TABLE ContactTbl("/ "ID INTEGER PRIMARY KEY,"/ "Name VARCHAR(80),"/ "TEL1 VARCHAR(20),"/ "EMAIL VARCHAR(40)"/ ");"; sqlite3_exec(db, sql, 0, 0, &zErrMsg); printf("%s/n",zErrMsg);
网上有许多查看和编辑sqlite3数据库文件的可视化小工具,例如:SQLiteSpy.exe;这样进行数据库分析和修改时就不必每次都自己写代码来操作了;
三、数据库插入
向刚才新建的表中添加一个条目,由于sqlite网站中都是英文数据类型,我使用UTF8编码格式的代码文件(XCode默认代码文件格式为UTF8编码)直接输入中文字符,能够正常执行,其他编码格式没有试过,感觉应该不会有什么问题,改天有时间尝试一下;
//insert three item sql = "INSERT INTO /"ContactTbl/" VALUES(NULL, '小康', '18602914000', '[email protected]');"; sqlite3_exec(db, sql, 0, 0, &zErrMsg); printf("%s/n",zErrMsg);
四、数据库查询
使用sqlite3_get_table()进行数据查询时,返回一个char **类型的字符数组;返回的行列值分别是表中数据的行和列数目;需要注意的是,返回的字符数组比实际数据多了一行表头;所以在使用和输出时需要注意;按照上面的数据格式,行、列值分别为1、4;而字符数组的数目为(nRow+1)*nColumn;
//query data, don't forget to free the result char **aResult = NULL; int nRow = 0; int nColumn = 0; sql = "SELECT * FROM ContactTbl"; sqlite3_get_table(db, sql, &aResult, &nRow, &nColumn, &zErrMsg); printf("%s/n",zErrMsg);
下面是格式输出代码:
//printf("ID/t/t姓名/t/t电话/t/t电子邮件/t/t/n"); //此处不需要输出表头,因为字符数组中已经包括表头 int rowIndex; for(rowIndex=0; rowIndex<(nRow+1)*nColumn; rowIndex++) { printf("%s/t/t", aResult[rowIndex]); if(0==(rowIndex+1)%nColumn) { printf("/n"); } } sqlite3_free_table(aResult);
例如下面这张表以及查询结果数据格式列举如下:
Name | Age
-----------------------
Alice | 43
Bob | 28
Cindy | 21
aResult[0] = "Name";
aResult[1] = "Age";
aResult[2] = "Alice";
aResult[3] = "43";
aResult[4] = "Bob";
aResult[5] = "28";
aResult[6] = "Cindy";
aResult[7] = "21";
简单说,获取到的字符数组就是将表中某行某列(包括表头),作为一个字符串,这样依次存储下来,成为一个字符串数组,编码格式为UTF8;
另外,由于查询返回的字符数组是在sqlite3_get_table()函数内部分配的内存空间,使用完成后需要使用sqlite3_free_table()函数进行释放,此处不能简单的通过sqlite3_free()函数释放;
五、数据库删除
数据库条目的删除和插入类似,代码如下:
//delete item sql = "DELETE FROM ContactTbl WHERE ID = 3;"; sqlite3_exec(db, sql, 0, 0, &zErrMsg); printf("%s/n",zErrMsg);
下面附上整个main.m的源代码:
// // main.m // sqlite3Test // // Created by kh on 10-11-22. // Copyright 2010 cx. All rights reserved. // #import
最后的删除语句用于在测试后删除数据库文件,避免重复执行后数据库中有重复条目,呵呵;针对以上代码,Consel输出如下:
(null) (null) (null) (null) (null) ID Name TEL1 EMAIL 1 小康 18602914000 [email protected] 2 小陈 18602935000 [email protected] 3 小霞 18602966000 [email protected] (null) After delete the ID 3 ID Name TEL1 EMAIL 1 小康 18602914000 [email protected] 2 小陈 18602935000 [email protected]