快速前往文章列表：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》
