1、准备工作
Cocos引擎的external文件夹里的sqlite3好像只有两个.h 文件,没有 sqlite3.c文件。所以我编译的时候一直编译不通过。后来去sqlite官网下了源文件,才编译成功的。
下载地址:http://www.sqlite.org/download.html
(2)将sqlite3的三个源文件拷贝到项目的Classes文件中,并导入到项目里。
如果是Android平台的话,还需要修改 Android.mk 文件。
2、sqlite3的基础API
这里只介绍一下sqlite3最基本的API,可以帮助你完成数据库的 增删改查 功能。
注意:sqlite3 数据库使用的编码格式为:UTF-8。如果出现乱码的话,就将其转为 UTF-8 格式。
2.1、关键数据结构:sqlite3*
从数据库打开开始,sqlite就要为这个类型准备好内存,直到数据库关闭,整个过程都需要用到这个类型。当数据库打开时开始,这个类型的变量就代表了你要操作的数据库。下面再详细介绍。
(1)filename : 数据库文件名(如:"/Users/apple/Documents/data.db" )。文件名不需要一定存在,如果此文件不存在,sqlite 会自动建立它。如果它存在,就尝试把它当数据库文件来打开。
(2)ppDb : 即前面提到的关键数据结构。这个结构底层细节如何,你不要关它。
(3)返回值: 如果为 sqlITE_OK ,则成功打开数据库。
这个函数是用来关闭数据库的。若不再使用数据库时,必须将数据库关闭,释放内存资源。
(1)sqlite3* : 即前面提到的关键数据结构。
(2)返回值: 如果为 sqlITE_OK ,则成功关闭数据库。
sqlite3_exec(sqlite3*,
*sql,
(*callback)(
void
*,monospace!important; font-size:1em!important; min-height:inherit!important">,monospace!important; font-size:1em!important; min-height:inherit!important">**,monospace!important; font-size:1em!important; min-height:inherit!important">**),monospace!important; font-size:1em!important; min-height:inherit!important">**errmsg)
|
(3)(*callback) : 执行exec时,每查到一条记录,就会调用这个回调函数(具体在 2.5 介绍)。
(4)void* : 传递数据,可以是任意值。会传递到回调函数callback,作为它的第一个参数传入。
(5)errmsg : 错误信息。
注意:后面三个参数,若不需要,可以填 NULL 。
(*sqlite3_callback)(
*para,monospace!important; font-size:1em!important; min-height:inherit!important">col_num,monospace!important; font-size:1em!important; min-height:inherit!important">**col_value,monospace!important; font-size:1em!important; min-height:inherit!important">**col_name)
|
这个函数作为 sqlite3_exec 的第三个参数。执行exec时,每查询到一条记录,就会调用一次。
(1)para : 即 exec 的第四个参数,传递来的数据。
(2)col_num : 一条记录有多少个字段(即这条记录的列数)。
(3)col_value : 查询出来的数据(即:每个字段的值 )。它是个一维数组(不要以为是2维数组),每个元素都是一个字符串 char * 值,是一个字段内容。
(4)col_name : 每一个字段的字段名称(即:列名),与 col_value 对应。
2.6、不使用回调查询数据库:sqlite3_get_table
sqlite3_get_table(sqlite3*db,constchar*sql,monospace!important; font-size:1em!important; min-height:inherit!important">***result,monospace!important; font-size:1em!important; min-height:inherit!important">*row,monospace!important; font-size:1em!important; min-height:inherit!important">*col,serif; font-size:14px"> 这个函数是用来查询数据库的。
|