MySQL 3.23 中文参考手册 |
|---|
|
|
|
| 2004-02-12 MySQL 译者:晏子 http://www.mysql.com/doc.html |
|
| |
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: %lun", (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 numericn");
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 nulln");
你可以使用下列方便的宏决来确定flags值的布尔状态：
IS_NOT_NULL(flags) 真，如果该字段被定义为NOT NULL
IS_PRI_KEY(flags) 真，如果该字段是一个主键
IS_BLOB(flags) 真，如果该字段是一个BLOB或TEXT（不推荐；相反测试field->type）
unsigned int decimals
对数字字段的小数位数。
|
| |
|
|
| |
|
发表评论
关闭窗口
|
|
|
|
