MYSQL_FIELD

最新推荐文章于 2025-11-13 09:47:05 发布

转载最新推荐文章于 2025-11-13 09:47:05 发布 · 1.1k 阅读

C/C++ 同时被 2 个专栏收录

197 篇文章

订阅专栏

mysql

19 篇文章

订阅专栏

MYSQL

这个结构表示对一个数据库连接的句柄，它被用于几乎所有的 MySQL 函数。

MYSQL_RES

这个结构代表返回行的一个查询的( SELECT , SHOW , DESCRIBE , EXPLAIN )的结果。从查询返回的信息在本章下文称为 结果集合 。

MYSQL_ROW

这是一个行数据的类型安全(type-safe)的表示。当前它实现为一个计数字节的字符串数组。（如果字段值可能包含二进制数据，你不能将这些视为空终止串，因为这样的值可以在内部包含空字节) 行通过调用 mysql_fetch_row() 获得。

MYSQL_FIELD

这个结构包含字段信息，例如字段名、类型和大小。其成员在下面更详细地描述。你可以通过重复调用 mysql_fetch_field() 对每一列获得 MYSQL_FIELD 结构。字段值不是这个结构的部分；他们被包含在一个 MYSQL_ROW 结构中。

MYSQL_FIELD_OFFSET

这是一个相对一个 MySQL 字段表的偏移量的类型安全的表示。（由 mysql_field_seek() 使用。) 偏移量是在一行以内的字段编号，从0开始。

my_ulonglong

该类型用于行编号和 mysql_affected_rows() 、 mysql_num_rows() 和 mysql_insert_id() 。这种类型提供 0 到 1.84e19 的一个范围。在一些系统上，试图打印类型 my_ulonglong 的值将不工作。为了打印出这样的值，将它变换到 unsigned long 并且使用一个 %lu 打印格式。例如：

printf (Number of rows: %lu/n", (unsigned long) mysql_num_rows(result));

MYSQL_FIELD 结构包含列在下面的成员：

char * name

字段名，是一个空结尾的字符串。

char * table

包含该字段的表的名字，如果它不是可计算的字段。对可计算的字段， table 值是一个空字符串。

char * def

这字段的缺省值，是一个空结尾的字符串。只要你使用，只有你使用 mysql_list_fields() 才可设置它。

enum enum_field_types type

字段类型。 type 值可以是下列之一：

类型值	类型含义
`FIELD_TYPE_TINY`	`TINYINT` 字段
`FIELD_TYPE_SHORT`	`SMALLINT` 字段
`FIELD_TYPE_LONG`	`INTEGER` 字段
`FIELD_TYPE_INT24`	`MEDIUMINT` 字段
`FIELD_TYPE_LONGLONG`	`BIGINT` 字段
`FIELD_TYPE_DECIMAL`	`DECIMAL` 或`NUMERIC` 字段
`FIELD_TYPE_FLOAT`	`FLOAT` 字段
`FIELD_TYPE_DOUBLE`	`DOUBLE` 或`REAL` 字段
`FIELD_TYPE_TIMESTAMP`	`TIMESTAMP` 字段
`FIELD_TYPE_DATE`	`DATE` 字段
`FIELD_TYPE_TIME`	`TIME` 字段
`FIELD_TYPE_DATETIME`	`DATETIME` 字段
`FIELD_TYPE_YEAR`	`YEAR` 字段
`FIELD_TYPE_STRING`	字符串(`CHAR` 或`VARCHAR` )字段
`FIELD_TYPE_BLOB`	`BLOB` 或`TEXT` 字段(使用`max_length` 决定最大长度）
`FIELD_TYPE_SET`	`SET` 字段
`FIELD_TYPE_ENUM`	`ENUM` 字段
`FIELD_TYPE_NULL`	`NULL` - 类型字段
`FIELD_TYPE_CHAR`	不推荐；使用`FIELD_TYPE_TINY` 代替

你可以使用IS_NUM() 宏来测试字段是否有一种数字类型。将type 值传给IS_NUM() 并且如果字段是数字的，它将计算为TRUE：

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

unsigned int length

字段宽度，在表定义中指定。

unsigned int max_length

对结果集合的字段的最大宽度(对实际在结果集合中的行的最长字段值的长度)。如果你使用 mysql_store_result() 或 mysql_list_fields() ，这包含字段最大长度。如果你使用 mysql_use_result() ，这个变量的值是零。

unsigned int flags

字段的不同位标志。 flags 值可以是零个或多个下列位设置：

标志值	标志含义
`NOT_NULL_FLAG`	字段不能是`NULL`
`PRI_KEY_FLAG`	字段是一个主键的一部分
`UNIQUE_KEY_FLAG`	字段是一个唯一键的一部分
`MULTIPLE_KEY_FLAG`	字段是一个非唯一键的一部分。
`UNSIGNED_FLAG`	字段有`UNSIGNED` 属性
`ZEROFILL_FLAG`	字段有`ZEROFILL` 属性
`BINARY_FLAG`	字段有`BINARY` 属性
`AUTO_INCREMENT_FLAG`	字段有`AUTO_INCREMENT` 属性
`ENUM_FLAG`	字段是一个`ENUM` （不推荐）
`BLOB_FLAG`	字段是一个`BLOB` 或`TEXT` （不推荐）
`TIMESTAMP_FLAG`	字段是一个`TIMESTAMP` （不推荐）

BLOB_FLAG 、ENUM_FLAG 和TIMESTAMP_FLAG 标志的使用是不推荐的，因为他们指出字段的类型而非它的类型属性。对FIELD_TYPE_BLOB 、FIELD_TYPE_ENUM 或FIELD_TYPE_TIMESTAMP ，最好是测试field->type 。下面例子演示了一个典型的flags 值用法：

if (field->flags & NOT_NULL_FLAG)
    printf("Field can't be null/n");

你可以使用下列方便的宏决来确定flags 值的布尔状态：

`IS_NOT_NULL(flags)`	真，如果该字段被定义为`NOT NULL`
`IS_PRI_KEY(flags)`	真，如果该字段是一个主键
`IS_BLOB(flags)`	真，如果该字段是一个`BLOB` 或`TEXT` （不推荐；相反测试`field->type` ）

unsigned int decimals

对数字字段的小数位数。

20.4.14 `mysql_fetch_field ()`

MYSQL_FIELD *mysql_fetch_field (MYSQL_RES *result)

20.4.14.1 说明

返回作为一个MYSQL_FIELD 结构的一个结果集合的一个列的定义。重复调用这个函数在结果集合中检索所有关于列的信息。当没有剩下更多的字段时，mysql_fetch_field () 返回NULL 。

在每次你执行一个新的SELECT 查询，mysql_fetch_field () 被重置（reset)以返回有关第一列的信息。由mysql_fetch_field () 返回的字段也受调用mysql_field_seek() 的影响。

如果你调用mysql_query() 在一张表上执行一个SELECT ，但是没调用mysql_store_result() ，如果你调用mysql_fetch_field () 询问一个BLOB 字段的长度，MySQL 返回缺省BLOB长度(8K字节)。（选择8K的长度是因为MySQL 不知道BLOB 的最大长度。这应该在某个时候是它可配置) 一旦你已经检索了结果集合，field->max_length 包含了在特定查询中对于该列最大值的长度。

20.4.14.2 返回值

当前列的MYSQL_FIELD 结构。如果没有列剩下，NULL 。

20.4.14.3 错误

无。

20.4.14.4 范例

MYSQL_FIELD *field;

while((field = mysql_fetch_field
(result)))
{
    printf("field name %s/n", field->name);
}

20.4.15 `mysql_fetch_fields()`

MYSQL_FIELD *mysql_fetch_fields(MYSQL_RES *result)

20.4.15.1 说明

返回一个结果集合的所有MYSQL_FIELD 结构的数组。每个结构提供结果结合中一列的字段定义。

20.4.15.2 返回值

一个结果集合的所有MYSQL_FIELD 结构的一个数组。

20.4.15.3 错误

无。

20.4.15.4 范例

unsigned int num_fields;
unsigned int i;
MYSQL_FIELD *fields;

num_fields = mysql_num_fields(result);
fields = mysql_fetch_fields(result);
for(i = 0; i < num_fields; i++)
{
   printf("Field %u is %s/n", i, fields[i].name);
}