SQLiteC/C++接口详细介绍之sqlite3类（十六）

返回目录：SQLite---免费开源数据库系列文章目录

上一篇：SQLiteC/C++接口详细介绍之sqlite3类（十五）

下一篇： SQLiteC/C++接口详细介绍之sqlite3类（十七）（未发表）

50.sqlite3_system_errno

函数功能：获取最近一次系统（操作系统）调用发生错误时的错误号（errno）。该函数在SQLite发生系统调用错误时非常有用，可以用于诊断操作系统应该依据errno提供的详细信息进一步解释该错误的根本原因。

函数原型如下：

cpp 复制代码

int sqlite3_system_errno(sqlite3*);

参数为指向sqlite3结构体的指针。
返回最近一次系统调用发生错误时的错误号（errno）。

下面是一个简单的示例，在代码中我们利用文件不存在这个错误，进行案例的演示：

cpp 复制代码

#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所对应的错误消息。

如果运行该示例，将会输出如下信息：

cpp 复制代码

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

功能：获取表中某一列的信息，包括列类型、是否为主键等信息。

函数的原型如下：

cpp 复制代码

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。

下面是一个示例：

cpp 复制代码

#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, &notNull, &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, &notNull, &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列的相关信息，这些信息分别包括：数据类型、排序规则、是否为非空列、是否为主键、是否为自增列值。

输出结果如下：

cpp 复制代码

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类型的值。

函数的原型如下：

cpp 复制代码

int sqlite3_total_changes(sqlite3*);
sqlite3_int64 sqlite3_total_changes64(sqlite3*);

参数是一个指向sqlite3结构体的指针，返回值是一个表示自连接建立以来所做的修改次数的整数值（或64位整数值）。

下面是一个示例，展示如何计算自打开数据库以来所做的更改总数：

cpp 复制代码

#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条记录。