MYSQL

此结构表示一个数据库连接的句柄。它几乎用于所有 MySQL 函数。请勿尝试复制 MYSQL 结构。无法保证此类副本可用。

MYSQL_RES

此结构表示返回行的查询的结果（SELECT、SHOW、DESCRIBE、EXPLAIN）。在本节的其余部分，从查询返回的信息称为结果集。

MYSQL_ROW

这是对一行数据的类型安全表示形式。它当前实现为一个计数字节字符串数组。（如果字段值可能包含二进制数据，则不能将它们视为以 null 结尾的字符串，因为此类值在内部可能包含 null 字节。）通过调用 mysql_fetch_row() 获取行。

MYSQL_FIELD

此结构包含元数据：有关字段的信息，例如字段的名称、类型和大小。其成员将在本节后面详细介绍。您可以通过重复调用 mysql_fetch_field() 来获取每个字段的 MYSQL_FIELD 结构。字段值不是此结构的一部分；它们包含在 MYSQL_ROW 结构中。

MYSQL_FIELD_OFFSET

这是对 MySQL 字段列表中偏移量的类型安全表示形式。（由 mysql_field_seek() 使用。）偏移量是行内的字段编号，从零开始。

my_ulonglong

用于 64 位无符号整数的类型。在 MySQL 8.0.18 之前使用 my_ulonglong 类型。从 MySQL 8.0.18 开始，请改用 uint64_t C 类型。

my_bool

布尔类型，用于值为 true（非零）或 false（零）。在 MySQL 8.0 之前使用 my_bool 类型。从 MySQL 8.0 开始，请改用 bool 或 int C 类型。

char * name

字段的名称，以 null 结尾的字符串。如果使用 AS 子句为字段指定了别名，则 name 的值是别名。对于过程参数，为参数名称。

char * org_name

字段的名称，以 null 结尾的字符串。忽略别名。对于表达式，该值为一个空字符串。对于过程参数，为参数名称。

char * table

如果该字段不是计算字段，则为包含该字段的表的名称。对于计算字段，table 值为空字符串。如果该列是从视图中选择的，则 table 将命名该视图。如果使用 AS 子句为表或视图指定了别名，则 table 的值是别名。对于 UNION，该值为空字符串。对于过程参数，为过程名称。

char * org_table

表的名称，以 null 结尾的字符串。忽略别名。如果该列是从视图中选择的，则 org_table 将命名该视图。如果该列是从派生表中选择的，则 org_table 将命名基表。如果派生表包装了一个视图，则 org_table 仍然命名基表。如果该列是一个表达式，则 org_table 为空字符串。对于 UNION，该值为空字符串。对于过程参数，该值为过程名称。

char * db

字段所属数据库的名称，以 null 结尾的字符串。如果该字段是计算字段，则 db 为空字符串。对于 UNION，该值为空字符串。对于过程参数，为包含该过程的数据库的名称。

char * catalog

目录名称。该值始终为 "def"。

char * def

该字段的默认值，以 null 结尾的字符串。仅当您使用 mysql_list_fields() 时才会设置此值。

unsigned long length

字段的宽度。这对应于显示长度（以字节为单位）。

服务器在生成结果集之前确定 length 值，因此这是能够容纳结果列中最大值的的数据类型所需的最小长度，而无需事先知道查询为结果集生成的实际值。

对于字符串列，length 值取决于连接字符集。例如，如果字符集为 latin1（单字节字符集），则 SELECT 'abc' 查询的 length 值为 3。如果字符集为 utf8mb4（多字节字符集，其中字符最多占用 4 个字节），则 length 值为 12。

unsigned long max_length

结果集中字段的最大宽度（结果集中实际存在的行中最长字段值的长度，以字节为单位）。如果您使用 mysql_store_result() 或 mysql_list_fields()，则该字段包含字段的最大长度。如果您使用 mysql_use_result()，则此变量的值为零。

max_length 的值是结果集中值的字符串表示形式的长度。例如，如果检索 FLOAT 列且 “最宽” 值为 -12.345，则 max_length 为 7（'-12.345' 的长度）。

如果使用预处理语句，则默认情况下不会设置 max_length，因为对于二进制协议，值的长度取决于结果集中值的类型。（请参阅 第 6.2 节“C API 预处理语句数据结构”。）如果仍然需要 max_length 值，请使用 mysql_stmt_attr_set() 启用 STMT_ATTR_UPDATE_MAX_LENGTH 选项，这些长度将在调用 mysql_stmt_store_result() 时设置。（请参阅 第 6.4.3 节“mysql_stmt_attr_set()” 和 第 6.4.29 节“mysql_stmt_store_result()”。）

无符号整数 name_length

name 的长度。

无符号整数 org_name_length

org_name 的长度。

无符号整数 table_length

table 的长度。

无符号整数 org_table_length

org_table 的长度。

无符号整数 db_length

db 的长度。

无符号整数 catalog_length

catalog 的长度。

无符号整数 def_length

def 的长度。

无符号整数 flags

描述字段的位标志。flags 值可以设置下表中显示的一个或多个位。

其中一些标志指示数据类型信息，并由稍后描述的 field->type 成员中的 MYSQL_TYPE_xxx 值取代或与其结合使用

NUM_FLAG 指示列是数值型的。这包括类型为 MYSQL_TYPE_DECIMAL、MYSQL_TYPE_NEWDECIMAL、MYSQL_TYPE_TINY、MYSQL_TYPE_SHORT、MYSQL_TYPE_LONG、MYSQL_TYPE_FLOAT、MYSQL_TYPE_DOUBLE、MYSQL_TYPE_NULL、MYSQL_TYPE_LONGLONG、MYSQL_TYPE_INT24 和 MYSQL_TYPE_YEAR 的列。

NO_DEFAULT_VALUE_FLAG 指示列在其定义中没有 DEFAULT 子句。这不适用于 NULL 列（因为此类列的默认值为 NULL）或 AUTO_INCREMENT 列（它们具有隐含的默认值）。

以下示例说明了 flags 值的典型用法

if (field->flags & NOT_NULL_FLAG)
    printf("Field cannot be null\n");

您可以使用下表中显示的便捷宏来确定 flags 值的布尔状态。

无符号整数 decimals

数值字段的小数位数，以及时间字段的小秒精度。

无符号整数 charsetnr

一个 ID 号，指示字段的字符集/排序规则对。

通常，结果集中的字符值将转换为 character_set_results 系统变量指示的字符集。在这种情况下，charsetnr 对应于该变量指示的字符集。可以通过将 character_set_results 设置为 NULL 来禁止字符集转换。在这种情况下，charsetnr 对应于原始表列或表达式的字符集。另请参阅 连接字符集和排序规则。

要区分字符串数据类型的二进制数据和非二进制数据，请检查 charsetnr 值是否为 63。如果是，则字符集为 binary，这表示二进制数据而不是非二进制数据。这使您能够区分 BINARY 和 CHAR、VARBINARY 和 VARCHAR 以及 BLOB 类型和 TEXT 类型。

charsetnr 值与 SHOW COLLATION 语句的 Id 列或 INFORMATION_SCHEMA COLLATIONS 表的 ID 列中显示的值相同。您可以使用这些信息源来查看哪些字符集和排序规则由特定的 charsetnr 值指示

mysql> SHOW COLLATION WHERE Id = 63;
+-----------+---------+----+---------+----------+---------+
| Collation | Charset | Id | Default | Compiled | Sortlen |
+-----------+---------+----+---------+----------+---------+
| binary    | binary  | 63 | Yes     | Yes      |       1 |
+-----------+---------+----+---------+----------+---------+

mysql> SELECT COLLATION_NAME, CHARACTER_SET_NAME
       FROM INFORMATION_SCHEMA.COLLATIONS WHERE ID = 33;
+-----------------+--------------------+
| COLLATION_NAME  | CHARACTER_SET_NAME |
+-----------------+--------------------+
| utf8_general_ci | utf8               |
+-----------------+--------------------+

枚举 enum_field_types 类型

字段的类型。type 值可以是下表中显示的 MYSQL_TYPE_ 符号之一。

MYSQL_TYPE_TIME2、MYSQL_TYPE_DATETIME2 和 MYSQL_TYPE_TIMESTAMP2) 类型代码仅在服务器端使用。客户端看到的是 MYSQL_TYPE_TIME、MYSQL_TYPE_DATETIME 和 MYSQL_TYPE_TIMESTAMP 代码。

您可以使用 IS_NUM() 宏来测试字段是否具有数值类型。将 type 值传递给 IS_NUM()，如果字段是数值型的，则它将计算结果为 TRUE

if (IS_NUM(field->type))
    printf("Field is numeric\n");

ENUM 和 SET 值作为字符串返回。对于这些值，请检查 type 值是否为 MYSQL_TYPE_STRING 以及 flags 值中是否设置了 ENUM_FLAG 或 SET_FLAG 标志。