MySQL数据库学习手册之MySQL客户工具和APIWord格式文档下载.docx

1、如果你使用mysql_use_result，你必须保证没有其他线程在同一个连接上正在询问任何东西，直到结果集合被关闭。20.2 C API数据类型MYSQL这个结构表示对一个数据库连接的句柄，它被用于几乎所有的MySQL函数。MYSQL_RES这个结构代表返回行的一个查询的（SELECT, SHOW, DESCRIBE, EXPLAIN）的结果。从查询返回的信息在本章下文称为结果集合。MYSQL_ROW这是一个行数据的类型安全（type-safe）的表示。当前它实现为一个计数字节的字符串数组。（如果字段值可能包含二进制数据，你不能将这些视为空终止串，因为这样的值可以在内部包含空字节） 行通过调

2、用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（

3、）和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字段名，欢迎光临八一学习网,收藏本篇文章$False$是一个空结尾的字符串。char * table包含该字段的表的名字，如果它不是可计算的字段。对可计算的字

4、段，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

5、字段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_

6、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_re

7、sult（）或mysql_list_fields（），这包含字段最大长度。如果你使用mysql_use_result（），这个变量的值是零。unsigned int flags字段的不同位标志。flags值可以是零个或多个下列位设置：标志值 标志含义NOT_NULL_FLAG 字段不能是NULLPRI_KEY_FLAG 字段是一个主键的一部分UNIQUE_KEY_FLAG 字段是一个唯一键的一部分MULTIPLE_KEY_FLAG 字段是一个非唯一键的一部分。 UNSIGNED_FLAG 字段有UNSIGNED属性ZEROFILL_FLAG 字段有ZEROFILL属性BINARY_FLAG 字

8、段有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。下面例子演示了一个典型的f

9、lags值用法：if （field-flags & NOT_NULL_FLAG）Field cant be nulln你可以使用下列方便的宏决来确定flags值的布尔状态：IS_NOT_NULL（flags） 真，如果该字段被定义为NOT NULLIS_PRI_KEY（flags） 真，如果该字段是一个主键IS_BLOB（flags） 真，如果该字段是一个BLOB或TEXT（不推荐；相反测试field-type）unsigned int decimals对数字字段的小数位数。20.3 C API函数概述在 C API 中可用的函数列在下面，并且在下一节更详细地描述。见20.4 C API函数描

10、述。mysql_affected_rows（） 返回被最新的UPDATE, DELETE或INSERT查询影响的行数。mysql_close（） 关闭一个服务器连接。mysql_connect（） 连接一个MySQL服务器。该函数不推荐；使用mysql_real_connect（）代替。mysql_change_user（） 改变在一个打开的连接上的用户和数据库。mysql_create_db（） 创建一个数据库。而使用SQL命令CREATE DATABASE。mysql_data_seek（） 在一个查询结果集合中搜寻一任意行。mysql_debug（） 用给定字符串做一个DBUG_PUSH

11、。mysql_drop_db（） 抛弃一个数据库。该函数123456789 不推荐；而使用SQL命令DROP DATABASE。mysql_dump_debug_info（） 让服务器将调试信息写入日志文件。mysql_eof（） 确定是否已经读到一个结果集合的最后一行。这功能被反对; mysql_errno（）或mysql_error（）可以相反被使用。mysql_errno（） 返回最近被调用的MySQL函数的出错编号。mysql_error（） 返回最近被调用的MySQL函数的出错消息。mysql_escape_string（） 用在SQL语句中的字符串的转义特殊字符。mysql_fet

12、ch_field（） 返回下一个表字段的类型。mysql_fetch_field_direct （） 返回一个表字段的类型，给出一个字段编号。对与每个非-SELECT查询（例如，INSERT、UPDATE、DELETE等），你可以调用mysql_affected_rows（）知道有多少行受到影响（改变）。对于SELECT查询，你作为一个结果集合来检索选择的行。（注意一些语句是类SELECT的，他们返回行。这些包括SHOW、DESCRIBE和EXPLAIN。他们应该象SELECT语句相同的方式来对待。）对客户，有两种方法处理结果集合。一种方法是通过调用mysql_store_result（）立刻

13、检索全部结果。该函数从服务器获得查询返回的所有行，并将他们存储在客户端。第二种方法是对客户通过调用mysql_use_result（）初始化一个一行一行地结果集合的检索。该函数初始化检索，但是实际上不从服务器获得任何行。在两种情况中，你通过mysql_fetch_row（）存取行。用mysql_store_result（）、mysql_fetch_row（）储存取已经从服务器被取出的行。用mysql_use_result（）、mysql_fetch_row（）实际上从服务器检索行。调用mysql_fetch_lengths（）可获得关于每行中数据值尺寸的信息。在你用完一个结果集合以后，调用my

14、sql_free_result（）释放由它使用的内存。两种检索机制是互补的。客户程序应该选择最适合他们的要求的途径。在实践中，客户通常更愿意使用mysql_store_result（）。mysql_store_result（）的一个优点是既然行均被客户取到，你不仅能顺序存取行，你也能mysql_data_seek（）或mysql_row_seek（）在结果集合中前后移动以改变在结果集合中的当前行位置。你也能通过调用mysql_num_rows（）知道有多少行。另一方面，mysql_store_result（）的内存需求对较大结果集合可能很高，并且你最可能遇到out-of-memory情况。my

15、sql_use_result（）的一个优点是客户为结果集合需要较少的内存，因为它一次只是维持一行（并且因为有较少的分配开销，mysql_use_result（）能更快些）。欢迎光临八一学习网,点击这里查看更多文章教程缺点是你必须尽快处理每一行以避免困住服务器，你不必再结果集合中随意存取行（你只能顺序存取行），而且你不知道在结果集合中有多少行，直到你检索全部结果。还有，你必须检索出所有行，即使你在检索中途确定你已找到了想寻找的信息。API使得客户正确应答查询成为可能（仅检索必要的行），不用知道查询是否是一个SELECT。你可以通过在mysql_query（）（或mysql_real_query（

16、）之后调用mysql_store_result（）做到。如果结果集合调用成功并且查询是一个SELECT，你能读取行。如果结果集合调用，调用mysql_field_count（）确定结果是否是实际期望的。如果mysql_field_count（）返回0，查询没有返回数据（表明它是一个INSERT、UPDATE、DELETE等），所以不期望返回行。如果mysql_field_count（）是非零，查询应该有返回行，但是没有。这表明查询是一个失败的SELECT。见mysql_field_count（）如何能做到的例子的描述。max_length包含了在特定查询中对于该列最大值的长度。20.4.14.2 返回值当前列的MYSQL_FIELD结构。