您的位置：首页 > 数据库 > MySQL

MYSQL_FIELD

2015-07-15 12:00 507 查看 
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);
}
内容来自用户分享和网络整理，不保证内容的准确性，如有侵权内容，可联系管理员处理 点击这里给我发消息
标签： 
相关文章推荐
新的分享
章节导航