SQLite3(2):常用API

最新推荐文章于 2024-08-03 10:59:37 发布
最新推荐文章于 2024-08-03 10:59:37 发布
阅读量789 收藏 15
点赞数 15
分类专栏： Linux 文章标签： sqlite 数据库 linux c语言
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/weixin_42937740/article/details/140506189
版权

目录

一、sqlite3支持的语言与框架

二、数据库的打开和关闭

2.1 数据库的打开（sqlite3_open函数）

2.2 数据库的关闭（sqlite3_close函数）

三、执行SQL语句（sqlite3_exec函数） 

3.1 sqlite3_exec函数介绍

3.2 sqlite3_exec()函数应用

3.2.1 使用sqlite3_exec()函数创建表

3.2.2 使用sqlite3_exec()函数向表中插入数据 

3.2.3 使用sqlite3_exec()函数查询数据

3.2.4 void *data的作用是什么？

一、sqlite3支持的语言与框架

Python：通过Python的标准库sqlite3，可以在Python中访问SQLite3数据库；
Java：使用Java JDBC接口或者第三方库JDBC SQLite，可以在Java中访问SQLite3数据库；
C++：使用C++的SQLite3 API，可以在C++中访问SQLite3数据库；
.NET：通过ADO.NET提供的SQLite3数据提供程序，可以在.NET平台上访问SQLite3数据库；
Ruby：通过Ruby的sqlite3 gem，可以在Ruby中访问SQLite3数据库；
PHP：使用PHP内置的PDO SQLite类或SQLite扩展，可以在PHP中访问SQLite3数据库；
Node.js：通过node-sqlite3库，在Node.js中访问SQLite3数据库。

以下进行C语言的接口介绍

二、数据库的打开和关闭

2.1 数据库的打开（sqlite3_open函数）

sqlite3_open() 函数用于打开一个 SQLite 数据库文件的函数，函数原型如下：

int sqlite3_open(const char *filename, sqlite3 **ppDb);
  • 第一个参数为数据库文件的文件名，如果为":memory"，则表示创建内存中的数据库
  • 第二个参数是一个二级指针，它存储一个指向打开的数据库连接的指针，这个指针在后续地SQLite操作中使用

这个函数使用指定的数据库文件名（或 :memory:）打开一个新的数据库连接，并且把连接句柄返回给调用者如果连接成功，将会返回 SQLITE_OK 编码（0），否则将会返回其他错误代码。
需要注意的是，SQLite 数据库文件不存在时将会自动创建。如果 filename 参数为 NULL ，该函数返回 SQLITE_MISUSE （错用 SQLite 调用）错误。
例如，以下是在 C 语言中打开一个 SQLite 数据库的示例代码：

#include <stdio.h>
#include <sqlite3.h>

int main() {
    sqlite3 *db;
    /*打开数据库*/
    int rc = sqlite3_open("test.db", &db);
    if (rc == SQLITE_OK) {
        printf("已成功打开数据库\n");
        sqlite3_close(db); // 关闭数据库连接
    } else {
        fprintf(stderr, "无法打开数据库: %s\n", sqlite3_errmsg(db));
        sqlite3_close(db);
        return 1;
    }
    return 0;
}

2.2 数据库的关闭（sqlite3_close函数）

sqlite3_close() 函数用于关闭指定数据库连接的函数。函数原型如下：

int sqlite3_close(sqlite3*);

该函数接收一个被打开的数据库连接指针，如果成功关闭返回 SQLITE_OK 编码（0），否则返回其他错误代码。
在使用完SQLite数据库连接之后，应该释放它以避免资源泄漏和内存占用。调用 sqlite3_close() 函数将关闭数据库连接，并释放所有相关的资源，包括已编译的语句等。如果在关闭连接之前还有未完成的事务，则会自动回滚这些事务。
例如，以下是在 C 语言中关闭 SQLite 数据库连接的示例代码：

#include <sqlite3.h>

int main() {
    sqlite3 *db;
    int rc = sqlite3_open("test.db", &db);
    // 执行一些数据库操作
    // ...

    rc = sqlite3_close(db);
    if (rc == SQLITE_OK) {
      printf("Closed database successfully\n");
  } else {
      fprintf(stderr, "Can't close database: %s\n", sqlite3_errmsg(db));
  }

    return 0;
}

三、执行SQL语句（sqlite3_exec函数） 

3.1 sqlite3_exec函数介绍

sqlite3_exec() 函数用于在 SQLite 数据库连接上执行一条或多条 SQL 语句，并调用一个回调函数处理执行结果。该函数的原型如下：

int sqlite3_exec(
    sqlite3*,                                  /* 执行 SQL 命令的数据库连接 */
    const char *sql,                           /* 待执行的 SQL 命令 */
    int (*callback)(void*,int,char**,char**),  /* 在执行命令时的回调函数 */
    void *,                                    /* 作为第一个参数传递给回调函数的指针 */
    char **errmsg                              /* 用于存储错误消息的指针 */
);

该函数接收一个打开的数据库连接 sqlite3*，

待执行的 SQL 命令 sql，

以及一个回调函数 callback，

回调函数的参数列表决定了该函数在被调用时应接收哪些参数，并指定了它们的数据类型和顺序。

回调函数必须符合以下格式：

int (*callback)(void*, int, char**, char**);
  • 第一个参数 void*，是使用者传递给 sqlite3_exec() 调用的 void* 参数。
  • 第二个参数 int，是查询结果所返回的列数。
  • 第三个参数 char**，是包含每个结果集元素值的字符串数组。
  • 第四个参数 char**，是包含每个结果集元素的列名称的字符串数组。这通常会在 SELECT 语句中返回。

回调函数的返回值应为整数，并且通常全部返回0表示执行成功。如果需要提前终止查询或在回调函数过程中发现错误，可以返回非零值。
errmsg 是用于保存 sqlite3_exec() 返回的错误消息的指针。
当函数成功执行 SQL 命令时，将会返回 SQLITE_OK 编码（0），否则将会返回其他错误代码。如果在执行命令时发生错误，则 errmsg 将被设置为一个非空值，其中包含有关错误的详细信息。如果 errmsg 未被设置，则表示该函数执行成功。

3.2 sqlite3_exec()函数应用

3.2.1 使用sqlite3_exec()函数创建表

以下是一个使用 sqlite3_exec() 函数执行 SQL 命令的示例代码：

#include <sqlite3.h>
#include <stdio.h>

int main(int argc, char* argv[]) {
    sqlite3 *db;
    char *zErrMsg = 0;
    int rc;
    /*打开数据库*/
    rc = sqlite3_open("test.db", &db);
    if (rc) {
        fprintf(stderr, "Can't open database: %s\n", sqlite3_errmsg(db));
        sqlite3_close(db);
        return 1;
    } else {
        fprintf(stdout, "Opened database successfully\n");
    }

    /*创建表的SQL语句*/
    char *sql = "CREATE TABLE COMPANY("
        "ID INT PRIMARY KEY     NOT NULL,"
        "NAME           TEXT    NOT NULL,"
        "AGE            INT     NOT NULL);";

    /*执行SQL语句*/
    rc = sqlite3_exec(db, sql, 0, 0, &zErrMsg);
    if (rc != SQLITE_OK) {
        fprintf(stderr, "SQL error: %s\n", zErrMsg);
        sqlite3_free(zErrMsg);
    } else {
        printf("Table created successfully\n");
    }

    /*关闭数据库文件*/
    sqlite3_close(db);
    return 0;
}

编译命令

gcc -o CreateTable CreateTable.c -lsqlite3

测试

3.2.2 使用sqlite3_exec()函数向表中插入数据 

创建好表格以后我们就可以向其添加数据了：

#include <sqlite3.h>
#include <stdio.h>

int main(int argc, char* argv[]) {
    sqlite3 *db;
    char *zErrMsg = 0;
    int rc;

    /*打开数据库*/
    rc = sqlite3_open("test.db", &db);
    if (rc) {
        fprintf(stderr, "Can't open database: %s\n", sqlite3_errmsg(db));
        sqlite3_close(db);
        return 1;
    } else {
        fprintf(stdout, "Opened database successfully\n");
    }

    /*创建表的SQL语句*/
    char *sql = "INSERT INTO COMPANY (ID,NAME,AGE) VALUES (1, '张三', 32);"
        "INSERT INTO COMPANY (ID,NAME,AGE) VALUES (2, '李四', 33);"
        "INSERT INTO COMPANY (ID,NAME,AGE) VALUES (3, '王五', 30);"
        "INSERT INTO COMPANY (ID,NAME,AGE) VALUES (4, '王博', 32);"
        "INSERT INTO COMPANY (ID,NAME,AGE) VALUES (5, '李为', 33);"
        "INSERT INTO COMPANY (ID,NAME,AGE) VALUES (6, '赵倩', 30);";

    /*执行SQL语句*/
    rc = sqlite3_exec(db, sql, 0, 0, &zErrMsg);
    if (rc != SQLITE_OK) {
        fprintf(stderr, "SQL error: %s\n", zErrMsg);
        sqlite3_free(zErrMsg);
    } else {
        fprintf(stdout, "Records created successfully\n");
    }

    /*关闭数据库文件*/
    sqlite3_close(db);
    return 0;
}

在上述代码中，需要先调用sqlite3_open()函数打开数据库连接。然后，使用INSERT INTO语句将一条记录插入到"COMPANY"表格中。该记录包含三个字段，分别是"id"、"name"和"age"，对应的值分别为1、'张三'和32。最后，通过sqlite3_exec()函数执行SQL语句，并根据返回值判断操作是否成功。

编译命令

gcc -o InsertTable InsertTable.c -lsqlite3

测试 

 

3.2.3 使用sqlite3_exec()函数查询数据
#include <sqlite3.h>
#include <stdio.h>

// 回调函数
int callback(void *data, int argc, char **argv, char **azColName) {
    int i;
    printf("callback:\n");
    for(i = 0; i < argc; i++) {
       printf("%s = %s\n", azColName[i], argv[i] ? argv[i] : "NULL");
   }
    printf("\n");

    return 0;
}

int main () {
    sqlite3 *db;
    char *zErrMsg = 0; // 存储错误消息的指针
    int rc;

    rc = sqlite3_open("test.db", &db);
    if (rc != SQLITE_OK) {
       fprintf(stderr, "Can't open database: %s\n", sqlite3_errmsg(db));
       sqlite3_close(db);
       return 1;
   }

    const char* sql = "SELECT * from COMPANY";
    rc = sqlite3_exec(db, sql, callback, NULL, &zErrMsg);

    if (rc != SQLITE_OK) {
       fprintf(stderr, "SQL error: %s\n", zErrMsg);
       sqlite3_free(zErrMsg);
   } else {
       printf("Operation done successfully\n");
   }

    sqlite3_close(db);
    return rc;
}

在此示例中，我们定义了一个回调函数 callback()，该函数用于处理 sqlite3_exec() 执行结果。
接下来，我们打开一个名为 "test.db" 的 SQLite 数据库连接，并执行 SELECT 命令。
最后，我们通过检查 rc 和 zErrMsg 的返回值，判断查询是否成功并处理执行结果。

编译命令

gcc -o SearchTable SearchTable.c -lsqlite3

测试 

3.2.4 void *data的作用是什么？

void *data是sqlite3_exec()函数的第四个参数，它是一个用户定义的指针类型，提供了一个通用的方法来传递额外的数据给回调函数。sqlite3_exec()函数的高级用法
示例代码：

#include <sqlite3.h>
#include <stdio.h>

// 回调函数
int callback(void *data, int argc, char **argv, char **azColName) {
    int i;
    if(argv[0][0] == '1')
        printf("%s\n", (char *)data);
    for(i = 0; i < argc; i++) {
        printf("%s\t", argv[i] ? argv[i] : "NULL");
    }
    printf("\n");

    return 0;
}

int main () {
    sqlite3 *db;
    char *zErrMsg = 0; // 存储错误消息的指针
    int rc;

    rc = sqlite3_open("test.db", &db);
    if (rc != SQLITE_OK) {
        fprintf(stderr, "Can't open database: %s\n", sqlite3_errmsg(db));
        sqlite3_close(db);
        return 1;
    }

    char *str = "ID\t名字\t年龄";
    char *sql = "SELECT * from COMPANY";
    rc = sqlite3_exec(db, sql, callback, str, &zErrMsg);

    if (rc != SQLITE_OK) {
        fprintf(stderr, "SQL error: %s\n", zErrMsg);
        sqlite3_free(zErrMsg);
    } else {
        printf("Operation done successfully\n");
    }

    sqlite3_close(db);
    return rc;
}

编译命令

gcc -o SearchTable2 SearchTable2.c -lsqlite3

测试

四、总结

本文介绍了SQLite3地相关接口并进行了函数示例。

俺不是文盲
关注
专栏目录
SQLite3_API使用大全
12-28
SQLite3_API使用大全
SQLite3 API编程手册.pdf
07-18
关键数据结构：sqlite3* 类型是 SQLite 中最常用的数据结构，从数据库打开开始，SQLite 就要为这个类型准备好内存，直到数据库关闭，整个过程都需要用到这个类型。 ii. 打开数据库：使用 int sqlite3_open(文件名,...
SQLite3 API 学习
mao834099514的博客
06-15 6203
核心C  API:   查询封装：         连接与断开连接：                  其实就是打开数据库。可以使用函数sqlite3_open_v2( )、 sqlite3_open( ) 、sqlite3_ open16( )。其中sqlite3_open_v2( )函数功能最强大，也是最新的函数,尽量使用这个函数。                  打开数据库函
SQLite库笔记：API函数编程
最新发布
记录入坑和填坑的过往痕迹
08-03 1684
介绍SQLite库核心API函数，以及C语言示例代码
SQLite3基本编程手册
yavobo的专栏
03-04 1400
作者：董淳光相关链接：http://www.2ky.cn/h/149/4135.html 前序：... 1 一、 版本... 1 二、 基本编译... 2 三、 SQLITE操作入门... 2 （1） 基本流程... 2 （2） SQL语句操作... 4 （3） 操作二进制... 8 （4） 事务处理... 10 四、 给数据库加密... 10 五、 后记... 25 前序： Sq
sqlite3API函数
weixin_30448603的博客
08-25 493
回顾： DDL 表的创建、修改、删除 create table 表名(字段名 字段类型 [约束],...); alter table 表名 ｛rename to 新名字 | add column 字段 字段类型｝; drop table 表名 ; DML 记录的增、删、改、查 insert into 表名(字段名,...)values(字段值,...); insert into 表名...
【SQLite3】常用API
2201_75563094的博客
07-07 980
使用C语言控制，数据库的打开和关闭，执行SQL语句
m-PostgreSQL-and-SQLite3-：基本PostgreSQL和SQLite命令
02-15
对于SQLite3： ```python import sqlite3 conn = sqlite3.connect("your_dbname.db") cur = conn.cursor() cur.execute("SELECT * FROM your_table") rows = cur.fetchall() for row in rows: print(row) cur....
SQLite API教程：行数据存取与常用函数解析
"本资源主要介绍了SQLite数据库API的使用，特别是关于行数据存取的相关函数，包括`sqlite3_column_int`、`sqlite3_column_count`、`sqlite3_column_text`和`sqlite3_column_double`等。同时，还提及了数据库的打开与...
SQLite3入门教程：常用函数解析
对于初学者来说，SQLite3提供了简洁且直观的API接口，使得在应用程序中集成数据库功能变得容易。 1. 打开数据库 使用`sqlite3_open()`函数来打开或创建一个SQLite数据库。这个函数需要两个参数：一个是数据库文件的...
SQLite3基础教程：常用常量与错误代码解析
基本的C API调用包括sqlite3_open()用于打开数据库，sqlite3_exec()用于执行SQL命令，sqlite3_prepare_v2()和sqlite3_step()组合用于预编译和执行SQL语句，sqlite3_finalize()用于释放预编译的语句，最后使用sqlite3...
sqlite3 数据库api函数
11-15
sqlite3 数据库 的API接口函数以及编程
SQLite3 API介绍
11-04
SQLite3 API的中文介绍，比较其础的东西，比较适合入门级应用。
Sqlite3 Api
weixin_43152585的博客
04-09 190
Sqlite3 Api 数据库的打开 int sqlite3_open( const char *filename, /* Database filename (UTF-8) */ sqlite3 **ppDb /* OUT: SQLite db handle */ ); //返回值为 SQLITE_OK 表示操作正常 //例子 其中sqlite3 * ...
SQLite3的API简单应用
codemanship的专栏
09-26 767
首先是一个简单的应用：  test_sqlite.c [cpp] view plaincopy #include    #include        static int callback(void *NotUsed, int argc, char **argv, char **azColName)   {       in
sqlite3 api&cli
会点技术，懂点学术，搞点艺术
03-20 643
sqlite3常用编程接口与命令
Sqlite c/c++ api 学习
热门推荐
10-07 1万+
    Sqlite是我最喜欢使用的文件数据库，它小巧、方便、速度快、支持大部分标准sql语句、开源、免费 .. .. .. 优点太多了。自从认识了她之后，我就将Access打入了冷宫，发誓以后再也不用Access了。我们可以到Sqlite的官方网站下载Sqlite的源代码，编译后的结果只有200多K，太小巧，太卡哇依了。如果嫌自己手动编译麻烦，也可以直接从官网下载二进制的可执行文件或者动态链接库
sqlite API
Mr_weng
02-12 656
sqlite数据库的基本操作： 1.关键数据结构 sqlite 里最常用到的是 sqlite3 * 类型。从数据库打开开始，sqlite就要为这个类型准备好内存，直到数据库关闭，整个过程都需要用到这个类型。当数据库打开时开始，这个类型的变量就代表了你要操作的数据库。下面再详细介绍。 2.打开数据库 int sqlite3_open(filename, sqlit
sqlite3 API for C
weixin_45066336的博客
08-10 957
C语言调用接口操作sqlite数据库，本文只介绍了部分基本操作的接口，满足日常使用，包括接口的参数说明与代码使用示例
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值