SQLiteC/C++接口详细介绍之sqlite3类(六)

2024-03-15 07:52

本文主要是介绍SQLiteC/C++接口详细介绍之sqlite3类(六),希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

   快速前往文章列表:SQLite—系列文章目录 

 上一篇:SQLiteC/C++接口详细介绍之sqlite3类(五)

 下一篇:SQLiteC/C++接口详细介绍之sqlite3类(七)

19. sqlite3_changes与sqlite3_changes64

是SQLite中用于获取前一条SQL语句所影响的行数的API函数。其返回值为int型和sqlite3_int64型,用于不同位数的系统,其中sqlite3_changes是32位返回类型,sqlite3_changes64是64位返回类型。其用法非常简单,只需要在执行完一条更新数据库的SQL语句(比如INSERT、DELETE、UPDATE)之后调用这两个函数即可得到所影响的行数。需要注意的是,这个值只对最近执行的一条SQL语句有效,并在下一条SQL语句执行前被重置。

如:

#include <stdio.h>
#include <sqlite3.h>
int main() {sqlite3 *db;sqlite3_open(":memory:", &db); // 在内存中创建一个数据库char *sql = "CREATE TABLE test (id INTEGER PRIMARY KEY, info TEXT);""INSERT INTO test (info) VALUES ('Hello, World!');" // 创建表和插入一条数据sqlite3_exec(db, sql, 0, 0, 0); // 执行SQL语句int nrow = 0, ncol = 0;char **result;sqlite3_get_table(db, "SELECT * FROM test", &result, &nrow, &ncol, 0); // 查询表中的所有数据printf("Rows affected by the last SQL statement: %d\n", sqlite3_changes(db)); // 输出上一条SQL语句影响的行数sqlite3_close(db);return 0;
}

在这个示例中,我们创建了一个内存中的SQLite数据库,并创建了一个表和插入了一条数据。然后我们使用sqlite3_get_table函数查询了表中的所有数据,并输出了上一条SQL语句(即SELECT语句)所影响的行数。

注意的是,sqlite3_changes和sqlite3_changes64函数在查询语句(比如SELECT语句)中将返回0。

20. sqlite3_collation_needed与sqlite3_collation_needed16

sqlite3_collation_needed和sqlite3_collation_needed16是SQLite库中的回调函数,用于在执行SQL语句时请求注册协作关系函数,以更好地处理特定的数据比较及排序情况。

它们的定义如下:

```c
typedef void (*sqlite3_collation_needed_callback)(void*,sqlite3*,int,const char*);
typedef void (*sqlite3_collation_needed_callback16)(void*,sqlite3*,int,const void*);
```

这两个函数的作用是向第二个参数sqlite3中注册一个回调函数,当SQLite查询需要协作关系函数时将自动调用这个回调函数。根据当前环境,调用的是sqlite3_collation_needed还是sqlite3_collation_needed16。这两个函数的第一个参数是一个void*指针,指向sqlite3_collation_needed_callback或sqlite3_collation_needed_callback16所要调用的协作解析函数,第二个参数是一个void*指针,指向SQLite上下文对象,第三个参数是Callback函数提供的字符编码方式(sqlite3_collation_needed16是多字节编码方式),第四个参数是Callback函数请求注册的协作解析函数的名字。

这个函数的实现需要传入一个可选的参数指针,如果需要注册协作关系函数,则应该检查这个指针,如果它是非空值,则应该调用sqlite3_create_collation注册协作解析函数。

下面给出一个简单的示例,它会在执行SQL语句时注册一个协作关系函数:

#include <stdio.h>
#include <sqlite3.h>
int myCollation(void *data, int len1, const void *string1, int len2, const void *string2)
{return strncmp((const char*)string1, (const char*)string2, (len1 < len2) ? len1 : len2);
}
int main() {sqlite3 *db;sqlite3_open(":memory:", &db); // 在内存中创建一个数据库sqlite3_collation_needed(db, NULL, myCollation);  // 注册协作关系函数char *sql = "CREATE TABLE t1 (x TEXT);""INSERT INTO t1(x) VALUES('123');""SELECT * FROM t1 ORDER BY x COLLATE myCollation;"; // 使用自定义的协作关系函数排序sqlite3_exec(db, sql, NULL, NULL, NULL); // 执行SQL语句sqlite3_close(db);return 0;
}

在这个示例中,我们创建了一个内存中的SQLite数据库,并注册了一个名为myCollation的协作解析函数。然后,我们使用这个自定义排序规则对表t1中的数据进行排序。

注意:sqlite3_collation_needed和sqlite3_collation_needed16的主要区别在于,sqlite3_collation_needed所使用的字符编码方式是单字节的,而sqlite3_collation_needed16所使用的字符编码方式是多字节的,因此,它们注册的协作解析函数所接收的参数类型也不同。另外,sqlite3_collation_needed和sqlite3_collation_needed16只需要注册一次,之后所有查询将使用相同的协作解析函数。

21.sqlite3_commit_hook

SQLite库中的回调函数,用于在提交事务前执行自定义代码。

它的定义如下:

typedef int (*sqlite3_commit_hook_callback)(void *);

这个函数的作用是向SQLite数据库中注册一个回调函数,当执行每次提交事务前,将自动调用该回调函数。这个函数有一个void*类型的参数指针,可以将任何用户指定的数据对象传给该函数进行操作。这个函数的返回值是一个int类型的整数,如果返回值为1,则提交事务,否则回滚事务。例如,当在回调函数中检测到错误时,应该返回0来回滚事务。

如:

#include <stdio.h>
#include <sqlite3.h>
int myCommitHook(void *data) {printf("Before committing transaction\n");return 1; // 返回1表示提交事务
}
int main() {sqlite3 *db;sqlite3_open(":memory:", &db); // 在内存中创建一个数据库sqlite3_commit_hook(db, myCommitHook, NULL);  // 注册提交事务时的回调函数char *sql = "CREATE TABLE t1 (x TEXT);""BEGIN;""INSERT INTO t1(x) VALUES('123');""COMMIT;";sqlite3_exec(db, sql, NULL, NULL, NULL); // 执行SQL语句sqlite3_close(db);return 0;
}

在这个示例中,我们创建了一个内存中的SQLite数据库,并注册了一个名为myCommitHook的回调函数。然后,我们使用这个回调函数在提交事务前输出一条信息。

注意:sqlite3_commit_hook的主要作用是监视和控制事务,因此它只能在事务处理期间使用。如果没有启用事务,则sqlite3_commit_hook不会被调用。另外,一次提交事务操作会调用sqlite3_commit_hook回调函数一次,如果要执行多个操作时,需要在每次操作之前都调用sqlite3_commit_hook注册一个回调函数。

参考:

1.《C-language Interface Specification for SQLite》

这篇关于SQLiteC/C++接口详细介绍之sqlite3类(六)的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/811276

相关文章

Python FastMCP构建MCP服务端与客户端的详细步骤

《PythonFastMCP构建MCP服务端与客户端的详细步骤》MCP(Multi-ClientProtocol)是一种用于构建可扩展服务的通信协议框架,本文将使用FastMCP搭建一个支持St... 目录简介环境准备服务端实现(server.py)客户端实现(client.py)运行效果扩展方向常见问题结

Spring Boot 整合 Apache Flink 的详细过程

《SpringBoot整合ApacheFlink的详细过程》ApacheFlink是一个高性能的分布式流处理框架,而SpringBoot提供了快速构建企业级应用的能力,下面给大家介绍Spri... 目录Spring Boot 整合 Apache Flink 教程一、背景与目标二、环境准备三、创建项目 & 添

Java进程CPU使用率过高排查步骤详细讲解

《Java进程CPU使用率过高排查步骤详细讲解》:本文主要介绍Java进程CPU使用率过高排查的相关资料,针对Java进程CPU使用率高的问题,我们可以遵循以下步骤进行排查和优化,文中通过代码介绍... 目录前言一、初步定位问题1.1 确认进程状态1.2 确定Java进程ID1.3 快速生成线程堆栈二、分析

Java中的登录技术保姆级详细教程

《Java中的登录技术保姆级详细教程》:本文主要介绍Java中登录技术保姆级详细教程的相关资料,在Java中我们可以使用各种技术和框架来实现这些功能,文中通过代码介绍的非常详细,需要的朋友可以参考... 目录1.登录思路2.登录标记1.会话技术2.会话跟踪1.Cookie技术2.Session技术3.令牌技

java中BigDecimal里面的subtract函数介绍及实现方法

《java中BigDecimal里面的subtract函数介绍及实现方法》在Java中实现减法操作需要根据数据类型选择不同方法,主要分为数值型减法和字符串减法两种场景,本文给大家介绍java中BigD... 目录Java中BigDecimal里面的subtract函数的意思?一、数值型减法(高精度计算)1.

Macos创建python虚拟环境的详细步骤教学

《Macos创建python虚拟环境的详细步骤教学》在macOS上创建Python虚拟环境主要通过Python内置的venv模块实现,也可使用第三方工具如virtualenv,下面小编来和大家简单聊聊... 目录一、使用 python 内置 venv 模块(推荐)二、使用 virtualenv(兼容旧版 P

C/C++ chrono简单使用场景示例详解

《C/C++chrono简单使用场景示例详解》:本文主要介绍C/C++chrono简单使用场景示例详解,本文通过实例代码给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友... 目录chrono使用场景举例1 输出格式化字符串chrono使用场景China编程举例1 输出格式化字符串示

C++/类与对象/默认成员函数@构造函数的用法

《C++/类与对象/默认成员函数@构造函数的用法》:本文主要介绍C++/类与对象/默认成员函数@构造函数的用法,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录名词概念默认成员函数构造函数概念函数特征显示构造函数隐式构造函数总结名词概念默认构造函数:不用传参就可以

Pytorch介绍与安装过程

《Pytorch介绍与安装过程》PyTorch因其直观的设计、卓越的灵活性以及强大的动态计算图功能,迅速在学术界和工业界获得了广泛认可,成为当前深度学习研究和开发的主流工具之一,本文给大家介绍Pyto... 目录1、Pytorch介绍1.1、核心理念1.2、核心组件与功能1.3、适用场景与优势总结1.4、优

C++类和对象之默认成员函数的使用解读

《C++类和对象之默认成员函数的使用解读》:本文主要介绍C++类和对象之默认成员函数的使用方式,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录一、默认成员函数有哪些二、各默认成员函数详解默认构造函数析构函数拷贝构造函数拷贝赋值运算符三、默认成员函数的注意事项总结一