SQLiteC/C++接口详细介绍sqlite3_stmt类（八）

 返回：SQLite—系列文章目录   

 上一篇：SQLiteC/C++接口详细介绍sqlite3_stmt类（七）

下一篇： SQLiteC/C++接口详细介绍sqlite3_stmt类（九）

27、sqlite3_column_int

函数 `sqlite3_column_int` 用于返回结果集中指定列的整型数值。

下面是该函数的详细原型：

int sqlite3_column_int(
  sqlite3_stmt*,   /* Prepared statement */
  int N            /* Index of the column */
);

函数参数说明：

- 第一个参数是 sqlite3_stmt 类型的已编译 SQL 语句对象，这个对象里面包含了查询结果。
- 第二个参数是 int 类型的，表示查询结果中指定的列索引，从0开始计数。

返回值是函数返回相应列的整型数值。

示例：

sqlite3_stmt *stmt;
const char *query = "SELECT id FROM users WHERE name=?";
sqlite3_prepare_v2(db, query, -1, &stmt, NULL);
sqlite3_bind_text(stmt, 1, "Tom", -1, SQLITE_STATIC);
int id = sqlite3_column_int(stmt, 0);
printf("User id: %d\n", id);

上述示例代码是在已经创建了 sqlite3_stmt 类型的表达式对象 stmt，并且绑定了其值后，获取指定的列数据，并将其转换成整数值。如果列的类型不为整数类型，则在转换时会出现数据转换错误的问题。

28、函数 `sqlite3_column_int64` 用于返回结果集中指定列的64位整型数值。

下面是该函数的详细原型：

sqlite3_int64 sqlite3_column_int64(
  sqlite3_stmt*,   /* Prepared statement */
  int iCol         /* Index of the column */
);

函数参数说明：

- 第一个参数是 sqlite3_stmt 类型的已编译 SQL 语句对象，这个对象里面包含了查询结果。
- 第二个参数是 int 类型的，表示查询结果中指定的列索引，从0开始计数。

返回值是函数返回相应列的64位整型数值。

示例：

sqlite3_stmt *stmt;
const char *query = "SELECT count(*) FROM users";
sqlite3_prepare_v2(db, query, -1, &stmt, NULL);
sqlite3_int64 count = sqlite3_column_int64(stmt, 0);
printf("User count: %lld\n", count);

上述示例代码是在已经创建了 sqlite3_stmt 类型的表达式对象 stmt，并且绑定了其值后，获取指定的列数据，并将其转换成 64 位整数值。如果列的类型不为整数类型，则在转换时会出现数据转换错误的问题。

函数 `sqlite3_column_name` 用于返回结果集中指定列的名称。如果查询中列无别名或是查询中使用了 `AS` 语句为列指定了别名，则该函数返回的是列的原始名称。列名称的返回值是UTF-8编码的字符串。

下面是 `sqlite3_column_name` 函数的详细原型：

const char *sqlite3_column_name(
  sqlite3_stmt*,   /* Prepared statement */
  int N            /* Index of the column */
);

函数参数说明：

- 第一个参数是sqlite3_stmt类型的已编译SQL语句对象，这个对象里面包含了查询结果。
- 第二个参数是int类型的，表示查询结果中指定的列索引，从0开始计数。

返回值是char *类型的指针，指向指定列的名称的UTF-8编码的字符串。

下面是 `sqlite3_column_name` 函数的例子：

sqlite3_stmt *stmt;
const char *query = "SELECT name, age FROM users WHERE id=?";
sqlite3_prepare_v2(db, query, -1, &stmt, NULL);
sqlite3_bind_int(stmt, 1, 1);
int columnCount = sqlite3_column_count(stmt);
for (int i = 0; i < columnCount; i++) {
  const char *name = sqlite3_column_name(stmt, i);
  printf("Column %d Name: %s\n", i, name);
}

函数 `sqlite3_column_name16` 与 `sqlite3_column_name` 类似，不同之处在于返回值是指定列名称的UTF-16编码的字符串。

下面是函数 `sqlite3_column_name16` 的详细原型：

const void *sqlite3_column_name16(
  sqlite3_stmt*,   /* Prepared statement */
  int N            /* Index of the column */
);

函数参数说明：

- 第一个参数是 sqlite3_stmt 类型的已编译 SQL 语句对象，这个对象里面包含了查询结果。
- 第二个参数是 int 类型的，表示查询结果中指定的列索引，从0开始计数。

下面是 `sqlite3_column_name16` 函数的例子：

sqlite3_stmt *stmt;
const char *query = "SELECT name, age FROM users WHERE id=?";
sqlite3_prepare_v2(db, query, -1, &stmt, NULL);
sqlite3_bind_int(stmt, 1, 1);
int columnCount = sqlite3_column_count(stmt);
for (int i = 0; i < columnCount; i++) {
  const void *name = sqlite3_column_name16(stmt, i);
  printf("Column %d Name: %ls\n", i, (const wchar_t*)name);
}

在打印结果时，可以将 UTF-16 编码的字符串转换为宽字符字符串。

29、sqlite3_column_name

函数 `sqlite3_column_origin_name` 用于返回结果集中指定列的原始名称。与 `sqlite3_column_name` 不同的是，该函数返回的是列的原始名称，即使查询中存在别名或使用 `AS` 为列指定了别名，返回值仍然是列的原始名称。列名称的返回值是UTF-8编码的字符串。

下面是 `sqlite3_column_origin_name` 函数的详细原型：

const char *sqlite3_column_origin_name(
  sqlite3_stmt*,   /* Prepared statement */
  int N            /* Index of the column */
);

函数参数说明：

- 第一个参数是sqlite3_stmt类型的已编译SQL语句对象，这个对象里面包含了查询结果。
- 第二个参数是int类型的，表示查询结果中指定的列索引，从0开始计数。

返回值是char *类型的指针，指向指定列的原始名称的UTF-8编码的字符串。

下面是 `sqlite3_column_origin_name` 函数的例子：

sqlite3_stmt *stmt;
const char *query = "SELECT name AS user_name, age FROM users WHERE id=?";
sqlite3_prepare_v2(db, query, -1, &stmt, NULL);
sqlite3_bind_int(stmt, 1, 1);
int columnCount = sqlite3_column_count(stmt);
for (int i = 0; i < columnCount; i++) {
  const char *name = sqlite3_column_origin_name(stmt, i);
  printf("Column %d Origin Name: %s\n", i, name);
}

30、sqlite3_column_name16

函数 `sqlite3_column_origin_name16` 与 `sqlite3_column_origin_name` 类似，不同之处在于返回值是指定列的原始名称的UTF-16编码的字符串。

下面是函数 `sqlite3_column_origin_name16` 的详细原型：

const void *sqlite3_column_origin_name16(
  sqlite3_stmt*,   /* Prepared statement */
  int N            /* Index of the column */
);

函数参数说明：

- 第一个参数是 sqlite3_stmt 类型的已编译 SQL 语句对象，这个对象里面包含了查询结果。
- 第二个参数是 int 类型的，表示查询结果中指定的列索引，从0开始计数。

下面是 `sqlite3_column_origin_name16` 函数的例子：

sqlite3_stmt *stmt;
const char *query = "SELECT name AS user_name, age FROM users WHERE id=?";
sqlite3_prepare_v2(db, query, -1, &stmt, NULL);
sqlite3_bind_int(stmt, 1, 1);
int columnCount = sqlite3_column_count(stmt);
for (int i = 0; i < columnCount; i++) {
  const void *name = sqlite3_column_origin_name16(stmt, i);
  printf("Column %d Origin Name: %ls\n", i, (const wchar_t*)name);
}

在打印结果时，可以将 UTF-16 编码的字符串转换为宽字符字符串。