Cocos2d-x   发布时间:2022-05-02  发布网站:大佬教程  code.js-code.com
大佬教程收集整理的这篇文章主要介绍了Cocos数据篇[3.4](6) ――SQLite3数据库基础用法大佬教程大佬觉得挺不错的,现在分享给大家,也给大家做个参考。

【唠叨】

在Cocos2d-x中,简单数据存储,可以使用UserDefault。那么如何存储大量,不规则的数据?我们可以使用 sqlite数据库 存储数据。sqlite 是使用非常广泛嵌入式数据库,它有小巧 、高效、跨平台、开源免费和易操作的特点。@H_@R_673_11248@_18@所以大量的被用于手机、PDA、MP3播放器、以及机顶盒设备。

sqlite数据库是使用C语言来编写的,因此在Cocos2d-x使用SQLite也是得心应手。

@H_@R_673_11248@_18@本文介绍一下sqlite3数据库的基础用法:增删改查

PS:另外对于sqlite的可视化管理工具,本人使用的是 @H_@R_673_11248@_18@sqlitestudio,这个就自行了解吧。


【参

http://cn.cocos2d-x.org/tutorial/show?id=1351 (【官方文档】sqlite集成与用法)

http://blog.chinaunix.net/uid-8447633-id-3321394.htmlsqlite3使用总结)


【Demo下载】

https://github.com/shahdza/Cocos_LearningTest/tree/master/Sqlite3%E5%9F%BA%E7%A1%80%E7%94%A8%E6%B3%95




sqlite3】


1、准备工作

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

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

下载地址:http://www.sqlite.org/download.html

Cocos数据篇[3.4](6) ――SQLite3数据库基础用法s.width=650;" src="http://img.voidcn.com/vcimg/static/loading.png" data-src="http://s3.51cto.com/wyfs02/M00/59/CA/wKioL1TkqoDjgyFaAABIim5S4ik833.jpg">

(2)将sqlite3的三个源文件拷贝到项目的Classes文件中,并导入到项目里。

Cocos数据篇[3.4](6) ――SQLite3数据库基础用法s.width=650;" src="http://img.voidcn.com/vcimg/static/loading.png" data-src="http://s3.51cto.com/wyfs02/M01/59/CA/wKioL1TkrAvTwlsqAACr7MIYIUA012.jpg">

如果是Android平台的话,还需要修改 Android.mk 文件。

Cocos数据篇[3.4](6) ――SQLite3数据库基础用法s.width=650;" src="http://img.voidcn.com/vcimg/static/loading.png" data-src="http://s3.51cto.com/wyfs02/M01/59/CE/wKiom1Tkq27ik1X9AAC5PIxCEvI796.jpg">


2、sqlite3的基础API

这里只介绍一下sqlite3最基本的API,可以帮助你完成数据库的 增删改查 功能。

注意:sqlite3 数据库使用的编码格式为:UTF-8 。如果出现乱码的话,就将其转为 UTF-8 格式。


2.1、关键数据结构:sqlite3*

sqlite里最常用到的是:@H_@R_673_11248@_18@sqlite3* 类型。

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


2.2、打开数据库:sqlite3_open

@H_@R_673_11248@_18@int sqlite3_open(const char *fil@R_@R_673_11248@_8371@,sqlite3 **ppDb)

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

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

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

(3)@H_@R_673_11248@_18@返回值: 如果为 @R_555_5607@OK ,则成功打开数据库。


2.3、关闭数据库:sqlite3_close

@H_@R_673_11248@_18@int sqlite3_close(sqlite3 *)

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

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

(2)@R_555_5607@OK ,则成功关闭数据库。


2.4、执行sql语句:sqlite3_exec

@H_@R_673_11248@_18@int sqlite3_exec(sqlite3*,const char *sql,int (*callBACk)(void*,int,char**,char**),void*,char **errmsg)

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

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

(2)@H_@R_673_11248@_18@sql : 即sql语句(增删改查)。

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

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

(5)@H_@R_673_11248@_18@errmsg : 错误信息。

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


2.5、sqlite3_exec的回调函数callBACk

@H_@R_673_11248@_18@int (*sqlite3_callback)(void* para,int col_num,char** col_value,char** col_Name)

这个函数作为 sqlite3_exec 的第三个参数。执行exec时,每查询到一条记录,就会调用一次。

(1)@H_@R_673_11248@_18@para : 即 exec 的第四个参数,传递来的数据。

(2)@H_@R_673_11248@_18@col_num : 一条记录有多少个字段(即这条记录的列数)。

(3)@H_@R_673_11248@_18@col_value : 查询出来的数据(即:每个字段的值 )。它是个一维数组(不要以为是2维数组),每个元素都是一个字符串 char * 值,是一个字段内容。

(4)@H_@R_673_11248@_18@col_name : 每一个字段的字段名称(即:列名),与 col_value 对应。


2.6、不使用回调查询数据库:sqlite3_get_table

@H_@R_673_11248@_18@sqlite3_get_table(sqlite3 *db,char ***result,int *row,int *col,char **errmsg)

这个函数是用来查询数据库的。

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

(2)@H_@R_673_11248@_18@sql : 即sql查询语句。

(3)@H_@R_673_11248@_18@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 头文件。

//
	#include"sqlite3.h"
//

3.2、创建数据库

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

//
	//数据库路径
	std::stringpath="/soft/cocos2d-x-3.4/projects/Demo34/resources/data.db";
	std::stringsql;//sql语句
	intret;//执行结果,@R_555_5607@OK表示成功执行

	//创建sqlite数据库:sqlite3*
	sqlite3*pdb=nullptr;

	//打开sqlite数据库:sqlite3_open
	ret=sqlite3_open(path.c_str(),&pdb);

	//当sqllite数据库打开失败时
	if(ret!=@R_555_5607@OK){
		//获得sqltite数据库打开错误的信息
		constchar*errmsg=sqlite3_errmsg(pdb);
		CCLOG("sqliteopenerror:%s",errmsg);
		sqlite3_close(pdb);
		returnfalse;
	}
//

3.3、创建表

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

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

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

//
	//创建表的sql语句:createtable
	sql="createtablestudent(IDIntegerprimaryKeyautoincrement,nametext,sextext)";
	
	//执行sql语句:sqlite3_exec
	ret=sqlite3_exec(pdb,sql.c_str(),nullptr,nullptr);
	
	if(ret!=@R_555_5607@OK){
		CCLOG("createtablefailed");
	}
//

3.4、插入数据(增)

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

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

//
	//(1,'student1','male')
	sql="inserTintostudentvalues(1,'male')";
	ret=sqlite3_exec(pdb,nullptr);
	if(ret!=@R_555_5607@OK){
		CCLOG("insertdatafailed!");
	}

	//(2,'student3','female')
	sql="inserTintostudentvalues(2,'student2','female')";
	ret=sqlite3_exec(pdb,nullptr);
	if(ret!=@R_555_5607@OK){
		CCLOG("insertdatafailed!");
	}

	//(3,'male')
	sql="inserTintostudentvalues(3,nullptr);
	if(ret!=@R_555_5607@OK){
		CCLOG("insertdatafailed!");
	}
//

3.5、查询数据,使用sqlite3_exec(查)

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

//
	//查询语句
	sql="SELEct*fromstudent";
	ret=sqlite3_exec(pdb,&callBACk,(void*)"para",nullptr);

	
	//回调函数
	intcallBACk(void*para,intcol_num,char**col_value,char**col_Name)
	{
		CCLOG("%s:总共有%d个字段",(char*)para,col_num);

		for(inti=0;i<col_num;i++){
			CCLOG("%s=%s",col_name[i],col_value[i]);
		}

		CCLOG("------------------------------");//分隔符

		return0;
	}
//

控制台输出结果:

Cocos数据篇[3.4](6) ――SQLite3数据库基础用法s.width=650;" src="http://img.voidcn.com/vcimg/static/loading.png" data-src="http://s3.51cto.com/wyfs02/M00/59/CA/wKioL1Tk5gLhJCfoAAB40LWF3vk323.jpg">


3.6、删除数据(删)

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

//
	//删除第一条记录
	sql="deletefromstudentwherEID=1";
	ret=sqlite3_exec(pdb,nullptr);
	if(ret!=@R_555_5607@OK){
		CCLOG("deletedatafailed!");
	}
//

3.7、修改数据(改)

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

//
	//修改第三条记录的name字段
	sql="updatestudentsetname='Hello'wherEID=3";
	ret=sqlite3_exec(pdb,nullptr);
	if(ret!=@R_555_5607@OK){
		CCLOG("updatedatafailed!");
	}
//

3.8、查询数据,使用SQLite3_get_table(查)

使用SQLite3_get_table 来查询:SELEct * from 表名

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

//
	char**table;//查询结果
	intr,c;//行数、列数

	sql="SELEct*fromstudent";
	sqlite3_get_table(pdb,&table,&r,&c,nullptr);

	CCLOG("行数is%d,列数is%d",r,c);

	//第0行(0~c-1),为字段名
	//第1行(c~2*c-1),第一条记录
	//......
	for(inti=0;i<=r;i++){
		for(intj=0;j<c;j++){
			CCLOG("%s",table[i*c+j]);
		}
		CCLOG("------------------------------");
	}

	//记得是否查询表
	sqlite3_free_table(tablE);
//

控制台输出结果:

可以看到 ID = 1 的数据已经被删除了,并且ID = 3 的数据name被改为了 " Hello " 。

Cocos数据篇[3.4](6) ――SQLite3数据库基础用法s.width=650;" src="http://img.voidcn.com/vcimg/static/loading.png" data-src="http://s3.51cto.com/wyfs02/M00/59/CE/wKiom1Tk5R-DsWEYAABBhYWVxyk425.jpg">


3.9、关闭数据库

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

//
	sqlite3_close(pdb);
//

大佬总结

以上是大佬教程为你收集整理的Cocos数据篇[3.4](6) ――SQLite3数据库基础用法全部内容,希望文章能够帮你解决Cocos数据篇[3.4](6) ――SQLite3数据库基础用法所遇到的程序开发问题。

如果觉得大佬教程网站内容还不错,欢迎将大佬教程推荐给程序员好友。

本图文内容来源于网友网络收集整理提供,作为学习参考使用,版权属于原作者。
如您有任何意见或建议可联系处理。小编QQ:384754419,请注明来意。