返回目录：SQLite—免费开源数据库系列文章目录
上一篇：SQLiteC/C++接口详细介绍之sqlite3类（十五）
下一篇： SQLiteC/C++接口详细介绍之sqlite3类（十七）（未发表）
50.sqlite3_system_errno
函数功能：获取最近一次系统（操作系统）调用发生错误时的错误号（errno）。该函数在SQLite发生系统调用错误时非常有用，可以用于诊断操作系统应该依据errno提供的详细信息进一步解释该错误的根本原因。
函数原型如下：
int sqlite3_system_errno(sqlite3*);- 参数为指向sqlite3结构体的指针。
- 返回最近一次系统调用发生错误时的错误号（errno）。
下面是一个简单的示例，在代码中我们利用文件不存在这个错误，进行案例的演示：
#include <sqlite3.h>
#include <stdio.h>
#include <errno.h>
int main() {
sqlite3 *db;
sqlite3_open(":memory:", &db);
sqlite3_exec(db, "CREATE TABLE test (id INTEGER PRIMARY KEY, value TEXT)", NULL, NULL, NULL);
int ret = sqlite3_exec(db, "SELECT * FROM non_existing_table", NULL, NULL, NULL);
if (ret != SQLITE_OK) {
printf("SQLite error: %s\n", sqlite3_errmsg(db));
printf("System error: %d\n", sqlite3_system_errno(db));
printf("System error message: %s\n", strerror(sqlite3_system_errno(db)));
}
sqlite3_close(db);
return 0;
}该示例中我们在执行一个不存在的表的查询语句时，会导致SQLITE_ERROR的出现。可以利用sqlite3_system_errno()函数获取系统错误号，并使用strerror()函数将该错误号转换为可读的错误消息。输出结果中会包含errno所对应的错误消息。
如果运行该示例，将会输出如下信息：
SQLite error: no such table: non_existing_table
System error: 2
System error message: No such file or directory可以看到，该示例中由于执行了一个不存在的表查询语句，会导致系统错误号为2（ENOENT），表示找不到指定的文件或目录。
51.sqlite3_table_column_metadata
功能：获取表中某一列的信息，包括列类型、是否为主键等信息。
函数的原型如下：
int sqlite3_table_column_metadata(
sqlite3 *db, /* 数据库连接 */
const char *zDbName, /* 数据库名称，空表示当前数据库 */
const char *zTableName, /* 表名称 */
const char *zColumnName, /* 列名称，如果空则返回所有列 */
char const **pzDataType, /* 返回数据类型 */
char const **pzCollSeq, /* 返回排序规则的名称 */
int *pNotNull, /* 返回是否是NOT NULL的标志 */
int *pPrimaryKey, /* 返回是否是主键的标志 */
int *pAutoinc /* 返回是否是自增列的标志 */
);各个参数的含义如下：
- db：数据库连接句柄。
- zDbName：表所在的数据库的名称，为NULL表示当前连接的数据库。
- zTableName：表的名称。
- zColumnName：列的名称，可以为一个空指针，如果为NULL，则将返回指定表的所有列的信息。
- pzDataType：如果不为NULL，将得到列的类型信息的指针。
- pzCollSeq：如果不为NULL，则得到列的排序规则名称。
- pNotNull：如果不为NULL，则得到非空列的标志，如果列为非空，则为1，否则为0。
- pPrimaryKey：如果不为NULL，则得到主键的标志。如果列是主键，则为1，否则为0。
- pAutoinc：如果不为NULL，则得到列是否为自增的标志。如果列为自增长，则为1，否则为0。
下面是一个示例：
#include <sqlite3.h>
#include <stdio.h>
int main() {
sqlite3 *db;
sqlite3_open(":memory:", &db);
sqlite3_exec(db, "CREATE TABLE test (id INTEGER PRIMARY KEY AUTOINCREMENT, value TEXT NOT NULL)", NULL, NULL, NULL);
const char *dataType;
const char *collSeq;
int notNull;
int primaryKey;
int autoinc;
sqlite3_table_column_metadata(db, NULL, "test", "id", &dataType, &collSeq, ¬Null, &primaryKey, &autoinc);
printf("id info:\ndataType=%s\ncollSeq=%s\nnotNull=%d\nprimaryKey=%d\nautoinc=%d\n", dataType, collSeq, notNull, primaryKey, autoinc);
sqlite3_table_column_metadata(db, NULL, "test", "value", &dataType, &collSeq, ¬Null, &primaryKey, &autoinc);
printf("value info:\ndataType=%s\ncollSeq=%s\nnotNull=%d\nprimaryKey=%d\nautoinc=%d\n", dataType, collSeq, notNull, primaryKey, autoinc);
sqlite3_close(db);
return 0;
}该示例中我们创建了一张包含两个列的表，其中id列为主键、INT类型、自增，value列为TEXT类型、非空。
在程序中我们使用sqlite3_table_column_metadata()函数获取id列和value列的相关信息，这些信息分别包括：数据类型、排序规则、是否为非空列、是否为主键、是否为自增列值。
输出结果如下：
id info:
dataType=INTEGER
collSeq=BINARY
notNull=0
primaryKey=1
autoinc=1
value info:
dataType=TEXT
collSeq=BINARY
notNull=1
primaryKey=0
autoinc=0我们可以看到，id列是主键、INT类型、自增，而value列是TEXT类型、非空。
52.sqlite3_total_changes与sqlite3_total_changes64
函数功能：获取自数据库连接打开以来所做的修改总数，即INSERT、UPDATE和DELETE所影响的总行数。两个函数的主要区别在于，sqlite3_total_changes返回一个int类型的值，而sqlite3_total_changes64返回一个int64类型的值。
函数的原型如下：
int sqlite3_total_changes(sqlite3*);
sqlite3_int64 sqlite3_total_changes64(sqlite3*);参数是一个指向sqlite3结构体的指针，返回值是一个表示自连接建立以来所做的修改次数的整数值（或64位整数值）。
下面是一个示例，展示如何计算自打开数据库以来所做的更改总数：
#include <sqlite3.h>
#include <stdio.h>
int main() {
sqlite3 *db;
sqlite3_open(":memory:", &db);
sqlite3_exec(db, "CREATE TABLE test (id INTEGER PRIMARY KEY, value TEXT)", NULL, NULL, NULL);
sqlite3_exec(db, "INSERT INTO test (id, value) VALUES (1, 'hello')", NULL, NULL, NULL);
sqlite3_exec(db, "UPDATE test SET value = 'world' WHERE id = 1", NULL, NULL, NULL);
sqlite3_exec(db, "DELETE FROM test WHERE id = 1", NULL, NULL, NULL);
int changes = sqlite3_total_changes(db);
printf("Total changes: %d\n", changes);
sqlite3_int64 changes64 = sqlite3_total_changes64(db);
printf("Total changes (int64): %lld\n", changes64);
sqlite3_close(db);
return 0;
}在该示例中，我们创建了一个test表，并进行了一些INSERT、UPDATE和DELETE操作。然后我们使用sqlite3_total_changes()和sqlite3_total_changes64()函数获取自打开数据库以来所做的更改总数。输出结果如下：
Total changes: 3
Total changes (int64): 3
可以看到，该示例中自打开数据库以来所做的更改总数为3条记录。
