临邑县住房和城乡建设局网站,垣曲网站建设,四川网站制作哪家好,公司网站建设模块快速前往文章列表#xff1a;SQLite—系列文章目录 上一篇#xff1a;SQLiteC/C接口详细介绍之sqlite3类#xff08;五#xff09; 下一篇#xff1a;SQLiteC/C接口详细介绍之sqlite3类#xff08;七#xff09; 19. sqlite3_changes与sqlite3_changes64
是SQLite中用… 快速前往文章列表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》
