Cocos2d-x数据篇06:SQLite3数据库基础用法

前端之家收集整理的这篇文章主要介绍了Cocos2d-x数据篇06:SQLite3数据库基础用法前端之家小编觉得挺不错的,现在分享给大家,也给大家做个参考。

1、准备工作

Cocos引擎的external文件夹里的sqlite3好像只有两个.h 文件,没有 sqlite3.c文件。所以我编译的时候一直编译不通过。后来去sqlite官网下了源文件,才编译成功的。

(1)首先,到下载sqlite3的源文件

下载地址: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里最常用到的是:sqlite3* 类型。

数据库打开开始,sqlite就要为这个类型准备好内存,直到数据库关闭,整个过程都需要用到这个类型。当数据库打开时开始,这个类型的变量就代表了你要操作的数据库。下面再详细介绍。

2.2、打开数据库sqlite3_open

1
int sqlite3_open( const char *filename,sqlite3**ppDb)

这个函数是用来打开数据库的。

(1)filename : 数据库文件名(如:"/Users/apple/Documents/data.db" )。文件名不需要一定存在,如果此文件不存在,sqlite 会自动建立它。如果它存在,就尝试把它当数据库文件来打开。

(2)ppDb : 即前面提到的关键数据结构。这个结构底层细节如何,你不要关它。

(3)返回值: 如果为 sqlITE_OK ,则成功打开数据库

2.3、关闭数据库sqlite3_close

sqlite3_close(sqlite3*)

这个函数是用来关闭数据库的。若不再使用数据库时,必须将数据库关闭,释放内存资源。

(1)sqlite3* : 即前面提到的关键数据结构。

(2)返回值: 如果为 sqlITE_OK ,则成功关闭数据库

2.4、执行sql语句:sqlite3_exec

1
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)

这个函数是用来执行sql语句的,对数据库进行:增删改查。

(2)sql : 即sql语句(增删改查)。

(3)(*callback) : 执行exec时,每查到一条记录,就会调用这个回调函数(具体在 2.5 介绍)。

(4)void* : 传递数据,可以是任意值。会传递到回调函数callback,作为它的第一个参数传入。

(5)errmsg : 错误信息。

注意:后面三个参数,若不需要,可以填 NULL 。

2.5、sqlite3_exec的回调函数callback

1
(*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

1
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"> 这个函数是用来查询数据库的。

(1)db:即前面提到的关键数据结构。

(2)sql:即SQL查询语句。

(3)result:查询结果。它依然一维数组(不要以为是二维数组,更不要以为是三维数组)。它内存布局是:第一行是字段名称,后面是紧接着是每个字段的值。即:0~col-1是字段名称,col~2*col-1是第一行记录,2*col~3*col-1是第二行记录,……以此类推。

(4)row:行数。

(5)col:列数。

(6)errmsg:错误信息。

注意:这个函数的result访问完后,需要使用sqlite3_free_table(retult),释放资源。

3、使用方法

3.1、引入头文件

添加sqlite官网下载的源代码 sqlite3.h 头文件

1
2
3
//
#include "sqlite3.h"
//

3.2、创建数据库

创建数据库,若文件不存在,sqlite会自动建立。若文件存在,就尝试把它当数据库文件来打开。

3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
//数据库路径
std::stringpath= "/soft/cocos2d-x-3.4/projects/Demo34/Resources/data.db" ;
std::stringsql; //sql语句
ret; //执行结果,sqlITE_OK表示成功执行
//创建sqlite数据库sqlite3*
sqlite3*pdb=nullptr;
//打开sqlite数据库sqlite3_open
ret=sqlite3_open(path.c_str(),&pdb);
//当sqllite数据库打开失败时
if (ret!=sqlITE_OK){
//获得sqltite数据库打开错误的信息
*errmsg=sqlite3_errmsg(pdb);
CCLOG( "sqliteopenerror:%s" sqlite3_close(pdb);
return false ;
}
3.3、创建表

创建一张表:create table 表名(ID,name,sex)

表名:student 。 有三个字段:ID、name、sex (其中ID为主键自增)。

PS:创建表,不需要回调函数sqlite3_exec 的后面三个参数都填NULL。

11
//创建表的sql语句:createtable
sql= "createtablestudent(IDintegerprimarykeyautoincrement,nametext,sextext)"
//执行sql语句:sqlite3_exec
ret=sqlite3_exec(pdb,sql.c_str(),nullptr,nullptr);
(ret!=sqlITE_OK){
"createtable@R_404_159@" );
}
3.4、插入数据(增)

插入三条数据:insert into 表名 value(1,"name","sex")

PS:插入数据,不需要回调函数sqlite3_exec 的后面三个参数都填 NULL 。

@H_502_461@ 21
22
//(1,'student1','male')
"insertintostudentvalues(1,'male')" (ret!=sqlITE_OK){
"insertdata@R_404_159@!" );
}
//(2,'student3','female')
"insertintostudentvalues(2,'student2','female')" ;
(ret!=sqlITE_OK){
);
}
//(3,'male')
"insertintostudentvalues(3,monospace!important; font-size:1em!important; min-height:inherit!important">;
(ret!=sqlITE_OK){
);
}
3.5、查询数据,使用sqlite3_exec(查)

使用 sqlite3_exec 来查询:select * from 表名

20
//查询语句
"select*fromstudent" *) "para"
//回调函数
callback( **col_name)
{
"%s:总共有%d个字段" *)para,col_num);
for ( i=0;i<col_num;i++){
"%s=%s" "------------------------------" ); //分隔符
return 0;
}
控制台输出结果:

3.6、删除数据(删)

删除第一条记录:delete from 表名 where 条件

8
//删除第一条记录
"deletefromstudentwhereID=1" "deletedata@R_404_159@!" }
3.7、修改数据(改)

修改数据:update 表名 set name = "hello" where 条件

//修改第三条记录的name字段
"updatestudentsetname='hello'whereID=3" "updatedata@R_404_159@!" 3.8、查询数据,使用sqlite3_get_table(查)

使用 sqlite3_get_table 来查询:select * from 表名

查询完后,不使用回调函数,而是直接保存查询结果。

**table;//查询结果
r,c; //行数、列数
;
sqlite3_get_table(pdb,&table,&r,&c,monospace!important; font-size:1em!important; min-height:inherit!important; color:blue!important">"行数is%d,列数is%d" //第0行(0~c-1),为字段名
//第1行(c~2*c-1),第一条记录
//......
i=0;i<=r;i++){
j=0;j<c;j++){
"%s" }
);
}
//记得是否查询
sqlite3_free_table(table);
可以看到 ID = 1 的数据已经被删除了,并且ID = 3 的数据name被改为了 " hello " 。

3.9、关闭数据库

最后,记得关闭数据库,否则会造成内存泄露。

sqlite3_close(pdb);

猜你在找的Cocos2d-x相关文章