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》