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

最新推荐文章于 2021-01-26 20:29:07 发布

转载最新推荐文章于 2021-01-26 20:29:07 发布 · 728 阅读

cocos2dx 专栏收录该内容

75 篇文章

订阅专栏

本文介绍了如何使用SQLite3数据库，包括数据库的创建、打开、关闭，以及如何执行SQL语句进行数据的增删改查等基本操作。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

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

 
        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

 
        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_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,
        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::string path = 
        "/soft/cocos2d-x-3.4/projects/Demo34/Resources/data.db"
        ;
       
        std::string sql; 
        // sql语句
       
        int 
        ret;         
        // 执行结果，SQLITE_OK表示成功执行
       
        // 创建sqlite数据库：sqlite3*
       
        sqlite3* pdb = nullptr;
       
        // 打开sqlite数据库：sqlite3_open
       
        ret = sqlite3_open(path.c_str(), &pdb);
       
        // 当sqllite数据库打开失败时
       
        if 
        (ret != SQLITE_OK) {
       
        // 获得sqltite数据库打开错误的信息
       
        const 
        char
        * errmsg = sqlite3_errmsg(pdb);
       
        CCLOG(
        "sqlite open error: %s"
        , errmsg);
       
        sqlite3_close(pdb);
       
        return 
        false
        ;
       
        }
       
        //

3.3、创建表

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

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

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

 
        //
       
        // 创建表的sql语句：create table
       
        sql = 
        "create table student(ID integer primary key autoincrement, name text, sex text)"
        ;
       
        // 执行sql语句：sqlite3_exec
       
        ret = sqlite3_exec(pdb, sql.c_str(), nullptr, nullptr, nullptr);
       
        if
        (ret != SQLITE_OK) {
       
        CCLOG(
        "create table failed"
        );
       
        }
       
        //

3.4、插入数据（增）

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

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

 
        //
       
        // (1 , 'student1' , 'male')
       
        sql = 
        "insert into student values(1, 'student1', 'male')"
        ;
       
        ret = sqlite3_exec(pdb, sql.c_str(), nullptr, nullptr, nullptr);
       
        if
        (ret != SQLITE_OK) {
       
        CCLOG(
        "insert data failed!"
        );
       
        }
       
        // (2 , 'student3' , 'female')
       
        sql = 
        "insert into student values(2, 'student2', 'female')"
        ;
       
        ret = sqlite3_exec(pdb, sql.c_str(), nullptr, nullptr, nullptr);
       
        if
        (ret != SQLITE_OK) {
       
        CCLOG(
        "insert data failed!"
        );
       
        }
       
        // (3 , 'student3' , 'male')
       
        sql = 
        "insert into student values(3, 'student3', 'male')"
        ;
       
        ret = sqlite3_exec(pdb, sql.c_str(), nullptr, nullptr, nullptr);
       
        if
        (ret != SQLITE_OK) {
       
        CCLOG(
        "insert data failed!"
        );
       
        }
       
        //

3.5、查询数据，使用sqlite3_exec（查）

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

 
        //
       
        // 查询语句
       
        sql = 
        "select * from student"
        ;
       
        ret = sqlite3_exec(pdb, sql.c_str(), &callback, (
        void
        *)
        "para"
        , nullptr);
       
        // 回调函数
       
        int 
        callback(
        void
        * para, 
        int 
        col_num, 
        char
        ** col_value, 
        char
        ** col_name)
       
        {
       
        CCLOG(
        "%s : 总共有 %d 个字段"
        , (
        char 
        *)para , col_num);
       
        for 
        (
        int 
        i = 0; i < col_num; i++) {
       
        CCLOG(
        "%s = %s"
        , col_name[i], col_value[i]);
       
        }
       
        CCLOG(
        "------------------------------"
        ); 
        // 分隔符
       
        return 
        0;
       
        }
       
        //

控制台输出结果：

3.6、删除数据（删）

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

 
        //
       
        // 删除第一条记录
       
        sql = 
        "delete from student where ID = 1"
        ;
       
        ret = sqlite3_exec(pdb, sql.c_str(), nullptr, nullptr, nullptr);
       
        if
        (ret != SQLITE_OK) {
       
        CCLOG(
        "delete data failed!"
        );
       
        }
       
        //

3.7、修改数据（改）

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

 
        //
       
        // 修改第三条记录的 name 字段
       
        sql = 
        "update student set name = 'hello' where ID = 3"
        ;
       
        ret = sqlite3_exec(pdb, sql.c_str(), nullptr, nullptr, nullptr);
       
        if
        (ret != SQLITE_OK) {
       
        CCLOG(
        "update data failed!"
        );
       
        }
       
        //

3.8、查询数据，使用sqlite3_get_table（查）

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

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

 
        //
       
        char
        ** table; 
        // 查询结果
       
        int 
        r, c;     
        // 行数、列数
       
        sql = 
        "select * from student"
        ;
       
        sqlite3_get_table(pdb, sql.c_str(), &table, &r, &c, nullptr);
       
        CCLOG(
        "行数 is %d , 列数 is %d"
        , r, c);
       
        // 第0行（0 ~ c-1），为字段名
       
        // 第1行（c ~ 2*c-1），第一条记录
       
        // ......
       
        for
        (
        int 
        i = 0; i <= r; i++) {
       
        for
        (
        int 
        j = 0; j < c; j++) {
       
        CCLOG(
        "%s"
        , table[i * c + j]);
       
        }
       
        CCLOG(
        "------------------------------"
        );
       
        }
       
        // 记得是否查询表
       
        sqlite3_free_table(table);
       
        //

控制台输出结果：

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

3.9、关闭数据库

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

 
        //
       
        sqlite3_close(pdb);
       
        //

【参考】

【官方文档】SQLite集成与用法

SQLite3使用总结