Cocos数据篇[3.4](6) ――SQLite3数据库基础用法

概述【唠叨】     在Cocos2d-x中，简单数据存储，可以使用UserDefault。那么如何存储大量，不规则的数据？我们可以使用 SQLite数据库 存储数据。SQLite 是使用非常广泛的 嵌入式数据库 ，它有小巧 、高效、跨平台、开源免费和易 *** 作的特点。所以大量的被用于手机、PDA、MP3播放器、以及机顶盒设备。     SQLite数据库是使用C语言来编写的，因此在Cocos2d-x使用

【唠叨】

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

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

本文介绍一下sqlite3数据库的基础用法：增删改查。

PS：另外对于sqlite的可视化管理工具，本人使用的是 sqliteStudio，这个就自行了解吧。

【参考】

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

http://blog.chinaunix.net/uid-8447633-id-3321394.html （sqlite3使用总结）

【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

650) this.wIDth=650;" src="http://img.jb51.cc/vcimg/static/loading.png" title="1.png" alt="wKiol1TkqoDjgyFaAABIim5S4ik833.jpg" src="http://s3.51cto.com/wyfs02/M00/59/CA/wKiol1TkqoDjgyFaAABIim5S4ik833.jpg">

（2）将sqlite3的三个源文件拷贝到项目的Classes文件中，并导入到项目里。

650) this.wIDth=650;" src="http://img.jb51.cc/vcimg/static/loading.png" title="2.png" alt="wKiol1TkrAvTwlsqAACr7MIYIUA012.jpg" src="http://s3.51cto.com/wyfs02/M01/59/CA/wKiol1TkrAvTwlsqAACr7MIYIUA012.jpg">

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

650) this.wIDth=650;" src="http://img.jb51.cc/vcimg/static/loading.png" title="3.png" alt="wKiom1Tkq27ik1X9AAC5PIxCEvI796.jpg" 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里最常用到的是：sqlite3* 类型。

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

2.2、打开数据库：sqlite3_open

int sqlite3_open(const char *file@R_404_6889@,sqlite3 **ppDb)

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

（1）file@R_404_6889@ ： 数据库文件名（如："/Users/apple/documents/data.db" ）。文件名不需要一定存在，如果此文件不存在，sqlite 会自动建立它。如果它存在，就尝试把它当数据库文件来打开。

（2）ppDb ： 即前面提到的关键数据结构。这个结构底层细节如何，你不要关它。

（3）返回值： 如果为 sqlITE_OK ，则成功打开数据库。

2.3、关闭数据库：sqlite3_close

int sqlite3_close(sqlite3 *)

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

（1）sqlite3* ： 即前面提到的关键数据结构。

（2）sqlITE_OK ，则成功关闭数据库。

2.4、执行SQL语句：sqlite3_exec

int sqlite3_exec(sqlite3*,const char *sql,int (*callback)(voID*,int,char**,char**),voID*,char **errmsg)

这个函数是用来执行SQL语句的，对数据库进行：增删改查。

（1）sqlite3* ： 即前面提到的关键数据结构。

（2）sql ： 即SQL语句（增删改查）。

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

（4）voID* ： 传递数据，可以是任意值。会传递到回调函数callback，作为它的第一个参数传入。

（5）errmsg ： 错误信息。

注意：后面三个参数，若不需要，可以填 NulL 。

2.5、sqlite3_exec的回调函数callback

int (*sqlite3_callback)(voID* para,int col_num,char** col_value,char** col_@R_404_6889@)

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

（1）para ： 即 exec 的第四个参数，传递来的数据。

（2）col_num ： 一条记录有多少个字段（即这条记录的列数）。

（3）col_value ： 查询出来的数据（即：每个字段的值 ）。它是个一维数组（不要以为是2维数组），每个元素都是一个字符串 char * 值，是一个字段内容。

（4）col_@R_404_6889@ ： 每一个字段的字段名称（即：列名），与 col_value 对应。

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

sqlite3_get_table(sqlite3 *db,char ***result,int *row,int *col,char **errmsg)

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

（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 头文件。

//	#include"sqlite3.h"//

3.2、创建数据库

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

//	//数据库路径	std::stringpath="/soft/cocos2d-x-3.4/projects/Demo34/Resources/data.db";	std::stringsql;//SQL语句	intret;//执行结果，sqlITE_OK表示成功执行	//创建sqlite数据库：sqlite3*	sqlite3*pdb=nullptr;	//打开sqlite数据库：sqlite3_open	ret=sqlite3_open(path.c_str(),&pdb);	//当sqllite数据库打开失败时	if(ret!=sqlITE_OK){		//获得sqltite数据库打开错误的信息		constchar*errmsg=sqlite3_errmsg(pdb);		cclOG("sqliteopenerror:%s",errmsg);		sqlite3_close(pdb);		returnfalse;	}//

3.3、创建表

创建一张表：create table 表名(ID,@R_404_6889@,sex)

表名：student 。 有三个字段：ID、@R_404_6889@、sex （其中ID为主键自增）。

PS：创建表，不需要回调函数。sqlite3_exec 的后面三个参数都填 NulL 。

//	//创建表的SQL语句：createtable	sql="createtablestudent(IDintegerprimarykeyautoincrement,@R_404_6889@text,sextext)";		//执行SQL语句：sqlite3_exec	ret=sqlite3_exec(pdb,sql.c_str(),nullptr,nullptr);		if(ret!=sqlITE_OK){		cclOG("createtableFailed");	}//

3.4、插入数据（增）

插入三条数据：insert into 表名 value(1,"@R_404_6889@","sex")

PS：插入数据，不需要回调函数。sqlite3_exec 的后面三个参数都填 NulL 。

//	//(1,'student1','male')	sql="insertintostudentvalues(1,'male')";	ret=sqlite3_exec(pdb,nullptr);	if(ret!=sqlITE_OK){		cclOG("insertdataFailed!");	}	//(2,'student3','female')	sql="insertintostudentvalues(2,'student2','female')";	ret=sqlite3_exec(pdb,nullptr);	if(ret!=sqlITE_OK){		cclOG("insertdataFailed!");	}	//(3,'male')	sql="insertintostudentvalues(3,nullptr);	if(ret!=sqlITE_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_@R_404_6889@)	{		cclOG("%s:总共有%d个字段",(char*)para,col_num);		for(inti=0;i<col_num;i++){			cclOG("%s=%s",col_@R_404_6889@[i],col_value[i]);		}		cclOG("------------------------------");//分隔符		return0;	}//

控制台输出结果：

650) this.wIDth=650;" src="http://img.jb51.cc/vcimg/static/loading.png" title="5.png" alt="wKiol1Tk5gLhJCfoAAB40LWF3vk323.jpg" 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!=sqlITE_OK){		cclOG("deletedataFailed!");	}//

3.7、修改数据（改）

修改数据：update 表名 set @R_404_6889@ = "hello" where 条件

//	//修改第三条记录的@R_404_6889@字段	sql="updatestudentset@R_404_6889@='hello'whereID=3";	ret=sqlite3_exec(pdb,nullptr);	if(ret!=sqlITE_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 的数据@R_404_6889@被改为了 " hello " 。

650) this.wIDth=650;" src="http://img.jb51.cc/vcimg/static/loading.png" title="6.png" alt="wKiom1Tk5R-DsWEYAABBhYWVxyk425.jpg" 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数据库基础用法所遇到的程序开发问题。

如果觉得内存溢出网站内容还不错，欢迎将内存溢出网站推荐给程序员好友。