- 这个结构表示对一个数据库连接的句柄,它被用于几乎所有的 MySQL 函数。
-
这个结构代表返回行的一个查询的(
SELECT
,SHOW
,DESCRIBE
,EXPLAIN
)的结果。从查询返回的信息在本章下文称为 结果集合 。 -
这是一个行数据的类型安全(type-safe)的表示。当前它实现为一个计数字节的字符串数组。(如果字段值可能包含二进制数据,你不能将这些视为空终止串,因为这样的值可以在内部包含空字节) 行通过调用
mysql_fetch_row()
获得。 -
这个结构包含字段信息,例如字段名、类型和大小。其成员在下面更详细地描述。你可以通过重复调用
mysql_fetch_field()
对每一列获得MYSQL_FIELD
结构。字段值不是这个结构的部分;他们被包含在一个MYSQL_ROW
结构中。 -
这是一个相对一个
MySQL 字段表的偏移量的类型安全的表示。(由
mysql_field_seek()
使用。) 偏移量是在一行以内的字段编号,从0开始。 -
该类型用于行编号和
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
MYSQL_RES
MYSQL_ROW
MYSQL_FIELD
MYSQL_FIELD_OFFSET
my_ulonglong
MYSQL_FIELD
结构包含列在下面的成员:
- 字段名,是一个空结尾的字符串。
-
包含该字段的表的名字,如果它不是可计算的字段。对可计算的字段,
table
值是一个空字符串。 -
这字段的缺省值,是一个空结尾的字符串。只要你使用,只有你使用
mysql_list_fields()
才可设置它。 -
字段类型。
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");
- 字段宽度,在表定义中指定。
-
对结果集合的字段的最大宽度(对实际在结果集合中的行的最长字段值的长度)。如果你使用
mysql_store_result()
或mysql_list_fields()
,这包含字段最大长度。如果你使用mysql_use_result()
,这个变量的值是零。 -
字段的不同位标志。
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
) - 对数字字段的小数位数。
char * name
char * table
char * def
enum enum_field_types type
unsigned int length
unsigned int max_length
unsigned int flags
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); }