分类： Mysql/postgreSQL
2008-05-12 15:11:53
MYSQL_ROW mysql_fetch_row(MYSQL_RES *result)
描述
检索结果集的下一行。在mysql_store_result()之后使用时，如果没有要检索的行，mysql_fetch_row()返回NULL。在mysql_use_result()之后使用时，如果没有要检索的行或出现了错误，mysql_fetch_row()返回NULL。
行内值的数目由mysql_num_fields(result)给出。如果行中保存了调用mysql_fetch_row()返回的值，将按照row[0]到row[mysql_num_fields(result)-1]，访问这些值的指针。行中的NULL值由NULL指针指明。
可以通过调用mysql_fetch_lengths()来获得行中字段值的长度。对于空字段以及包含NULL的字段，长度为0。通过检查字段值的指针，能够区分它们。如果指针为NULL，字段为NULL，否则字段为空。
返回值
下一行的MYSQL_ROW结构。如果没有更多要检索的行或出现了错误，返回NULL。
错误
注意，在对mysql_fetch_row()的两次调用之间，不会复位错误。
· CR_SERVER_LOST
在查询过程中，与服务器的连接丢失。
· CR_UNKNOWN_ERROR
出现未知错误。
示例：
MYSQL_ROW row;unsigned int num_fields;unsigned int i; num_fields = mysql_num_fields(result);while ((row = mysql_fetch_row(result))){ unsigned long *lengths; lengths = mysql_fetch_lengths(result); for(i = 0; i < num_fields; i++) { printf("[%.*s] ", (int) lengths[i], row[i] ? row[i] : "NULL"); } printf("\n");}unsigned int mysql_field_count(MYSQL *mysql)
描述
返回作用在连接上的最近查询的列数。
该函数的正常使用是在mysql_store_result()返回NULL（因而没有结果集指针）时。在这种情况下，可调用mysql_field_count()来判定mysql_store_result()是否应生成非空结果。这样，客户端就能采取恰当的动作，而无需知道查询是否是SELECT（或类似SELECT的）语句。在这里给出的示例中，演示了完成它的方法。
请参见25.2.13.1节，“为什么在mysql_query()返回成功后，mysql_store_result()有时会返回NULL”.
返回值
表示结果集中列数的无符号整数。
错误
无。
示例：
MYSQL_RES *result;unsigned int num_fields;unsigned int num_rows; if (mysql_query(&mysql,query_string)){ // error}else // query succeeded, process any data returned by it{ result = mysql_store_result(&mysql); if (result) // there are rows { num_fields = mysql_num_fields(result); // retrieve rows, then call mysql_free_result(result) } else // mysql_store_result() returned nothing; should it have? { if(mysql_field_count(&mysql) == 0) { // query does not return data // (it was not a SELECT) num_rows = mysql_affected_rows(&mysql); } else // mysql_store_result() should have returned data { fprintf(stderr, "Error: %s\n", mysql_error(&mysql)); } }}
另一种可选的方法是，用mysql_errno(&mysql)替换mysql_field_count(&mysql)调用。在该情况下，无论语句是否是SELECT，你将直接从mysql_store_result()查找错误，而不是从mysql_field_count()的值进行推断。
MYSQL_FIELD_OFFSET mysql_field_seek(MYSQL_RES *result, MYSQL_FIELD_OFFSET offset)
描述
将字段光标设置到给定的偏移处。对mysql_fetch_field()的下一次调用将检索与该偏移相关的列定义。
要想查找行的开始，请传递值为0的偏移量。
返回值
字段光标的前一个值。
错误
无。
MYSQL_FIELD_OFFSET mysql_field_tell(MYSQL_RES *result)
描述
返回上一个mysql_fetch_field()所使用的字段光标的定义。该值可用作mysql_field_seek()的参量。
返回值
字段光标的当前偏移量。
错误
无。
void mysql_free_result(MYSQL_RES *result)
描述
释放由mysql_store_result()、mysql_use_result()、mysql_list_dbs()等为结果集分配的内存。完成对结果集的操作后，必须调用mysql_free_result()释放结果集使用的内存。
释放完成后，不要尝试访问结果集。
返回值
无。
错误
无。
void mysql_get_character_set_info(MYSQL *mysql, MY_CHARSET_INFO *cs)
描述
该函数提供了关于默认客户端字符集的信息。可以使用mysql_set_character_set()函数更改默认的字符集。
该函数是在MySQL 5.0.10中增加的。
示例：
if (!mysql_set_character_set(&mysql, "utf8")){ MY_CHARSET_INFO cs; mysql_get_character_set_info(&mysql, &cs); printf("character set information:\n"); printf("character set name: %s\n", cs.name); printf("collation name: %s\n", cs.csname); printf("comment: %s\n", cs.comment); printf("directory: %s\n", cs.dir); printf("multi byte character min. length: %d\n", cs.mbminlen); printf("multi byte character max. length: %d\n", cs.mbmaxlen);}char *mysql_get_client_info(void)
描述
返回表示客户端库版本的字符串。
返回值
表示MySQL客户端库版本的字符串。
错误
无。
unsigned long mysql_get_client_version(void)
描述
返回表示客户端库版本的整数。该值的格式是XYYZZ，其中X是主版本号，YY是发布级别，ZZ是发布级别内的版本号。例如，值40102表示客户端库的版本是4.1.2。
返回值
表示MySQL客户端库版本的整数。
错误
无。
char *mysql_get_host_info(MYSQL *mysql)
描述
返回描述了所使用连接类型的字符串，包括服务器主机名。
返回值
代表服务器主机名和连接类型的字符串。
错误
无。
unsigned int mysql_get_proto_info(MYSQL *mysql)
描述
返回当前连接所使用的协议版本。
返回值
代表当前连接所使用协议版本的无符号整数。
错误
无。
char *mysql_get_server_info(MYSQL *mysql)
描述
返回代表服务器版本号的字符串。
返回值
代表服务器版本号的字符串。
错误
无。
unsigned long mysql_get_server_version(MYSQL *mysql)
描述
以整数形式返回服务器的版本号。
返回值
表示MySQL服务器版本的数值，格式如下：
major_version*10000 + minor_version *100 + sub_version
例如，对于5.0.12，返回500012。
在客户端程序中，为了快速确定某些与版本相关的服务器功能是否存在，该函数很有用。
错误
无。
unsigned long mysql_hex_string(char *to, const char *from, unsigned long length)
描述
该函数用于创建可用在SQL语句中的合法SQL字符串。请参见9.1.1节，“字符串”。
该字符串从形式上编码为十六进制格式，每个字符编码为2个十六进制数。结果被置入其中，并添加1个终结Null字节。
“from”所指向的字符串必须是长度字节“long”。必须为“to”分配缓冲区，缓冲区至少为length*2+1字节长。当mysql_hex_string()返回时，“to”的内容为由Null终结的字符串。返回值是编码字符串的长度，不包括终结用Null字符。
可采用0xvalue或X'value'格式将返回值置于SQL语句中。但是，返回值不包括0x或X'...'。调用者必须提供所希望的格式是何种。
示例：
char query[1000],*end; end = strmov(query,"INSERT INTO test_table values(");end = strmov(end,"0x");end += mysql_hex_string(end,"What's this",11);end = strmov(end,",0x");end += mysql_hex_string(end,"binary data: \0\r\n",16);*end++ = ')'; if (mysql_real_query(&mysql,query,(unsigned int) (end - query))){ fprintf(stderr, "Failed to insert row, Error: %s\n", mysql_error(&mysql));}
示例中所使用的strmov()函数包含在mysqlclient库中，它的工作方式类似于strcpy()，但返回指向第1个参数终结Null的指针。
返回值
置于“to”中的值的长度，不包括终结用Null字符。
错误
无。
char *mysql_info(MYSQL *mysql)
描述
检索字符串，该字符串提供了关于最近执行查询的信息，但仅对这里列出的语句有效。对于其他语句，mysql_info()返回NULL。字符串的格式取决于查询的类型，如本节所述。数值仅是说明性的，字符串包含与查询相适应的值。
· INSERT INTO ... SELECT ...
字符串格式：记录，100；副本，0；警告，0
· INSERT INTO ... VALUES (...),(...),(...)...
字符串格式：记录，3；副本，0；警告，0
· LOAD DATA INFILE ...
字符串格式：记录，1；删除，0；跳过，0；警告，0
· ALTER TABLE
字符串格式：记录，3；副本，0；警告，0
· UPDATE
字符串格式：匹配行，40；更改，40；警告，0
注意，mysql_info()为INSERT ... VALUES返回非NULL值，INSERT ... VALUES仅用于多行形式的语句（也就是说，仅当指定了多个值列表时）。
返回值
字符串，它表示最近所执行查询的额外信息。如果该查询无可用信息，返回NULL。
错误
无。
MYSQL *mysql_init(MYSQL *mysql)
描述
分配或初始化与mysql_real_connect()相适应的MYSQL对象。如果mysql是NULL指针，该函数将分配、初始化、并返回新对象。否则，将初始化对象，并返回对象的地址。如果mysql_init()分配了新的对象，当调用mysql_close()来关闭连接时。将释放该对象。
返回值
初始化的MYSQL*句柄。如果无足够内存以分配新的对象，返回NULL。
错误
在内存不足的情况下，返回NULL。
my_ulonglong mysql_insert_id(MYSQL *mysql)
描述
返回由以前的INSERT或UPDATE语句为AUTO_INCREMENT列生成的值。在包含AUTO_INCREMENT字段的表中执行了INSERT语句后，应使用该函数。
更准确地讲，将在下述条件下更新mysql_insert_id()：
· 将值保存到AUTO_INCREMENT列中的INSERT语句。无论值是通过在列中存储特殊值NULL或0自动生成的，还是确切的非特殊值，都成立。
· 在有多行INSERT语句的情况下，mysql_insert_id()返回第1个自动生成的AUTO_INCREMENT值，如果未生成这类值，将返回插入在AUTO_INCREMENT列中的最后1个确切值。
· 通过将LAST_INSERT_ID(expr)插入到任意列中以生成AUTO_INCREMENT值的INSERT语句。
· 通过更新任意列至LAST_INSERT_ID(expr)以生成AUTO_INCREMENT值的INSERT语句。
· mysql_insert_id()的值不受诸如SELECT等返回结果集的语句的影响。
· 如果前面的语句返回了错误，mysql_insert_id()的值将是不确定的。
注意，如果前面的语句未使用AUTO_INCREMENT，mysql_insert_id()返回0。如果需要保存值，在生成值的语句后，务必立刻调用mysql_insert_id()。
mysql_insert_id()的值仅受在当前客户端连接内发出的语句的影响。不受由其他客户端发出的语句的影响。
请参见12.9.3节，“信息函数”。
此外还应注意，SQL LAST_INSERT_ID()函数的值总包含最近生成的AUTO_INCREMENT值，而且在语句之间不会被复位，原因在于该函数的值是在服务器中维护的。另一个区别是，如果设置了AUTO_INCREMENT列来指定非特殊值，不会更新LAST_INSERT_ID()。
LAST_INSERT_ID()不同于mysql_insert_id()的原因在于，LAST_INSERT_ID()在脚本中很容易使用，而mysql_insert_id()则试图提供关于在AUTO_INCREMENT列中出现情况的更准确信息。
返回值
在前面的讨论中予以了介绍。
错误
无。
int mysql_kill(MYSQL *mysql, unsigned long pid)
描述
请求服务器杀死由pid指定的线程。
返回值
0表示成功，非0值表示出现错误。
错误
· CR_COMMANDS_OUT_OF_SYNC
以不恰当的顺序执行了命令。
· CR_SERVER_GONE_ERROR
MySQL服务器不可用。
· CR_SERVER_LOST
在查询过程中，与服务器的连接丢失。
· CR_UNKNOWN_ERROR
出现未知错误。
void mysql_library_end(void)
描述
它是mysql_server_end()函数的同义词。
关于具体的用法，请参见25.2.2节，“C API函数概述”。
int mysql_library_init(int argc, char **argv, char **groups)
描述
这是mysql_server_init()函数的同义词。
关于具体的用法，请参见25.2.2节，“C API函数概述”。
MYSQL_RES *mysql_list_dbs(MYSQL *mysql, const char *wild)
描述
返回由服务器上的数据库名称组成的结果集，该服务器与由通配符参数指定的简单正则表达式匹配。通配符参数可以包含通配符“%”或“_”，也可以是NULL指针，以便与所有的数据库匹配。调用mysql_list_dbs()的方法类似于执行查询SHOW database [LIKE wild]。
必须用mysql_free_result()释放结果集。
返回值
成功后返回MYSQL_RES结果集。如果出现错误，返回NULL。
错误
· CR_COMMANDS_OUT_OF_SYNC
以不恰当的顺序执行了命令。
· CR_OUT_OF_MEMORY
内存溢出。
· CR_SERVER_GONE_ERROR
MySQL服务器不可用。
· CR_SERVER_LOST
在查询过程中，与服务器的连接丢失。
· CR_UNKNOWN_ERROR
出现未知错误。
MYSQL_RES *mysql_list_fields(MYSQL *mysql, const char *table, const char *wild)
描述
返回由给定表中的字段名称组成的结果集，给定表与由通配符参数指定的简单正则表达式匹配。通配符参数可以包含通配符“%”或“_”，也可以是NULL指针，以便与所有的字段匹配。调用mysql_list_fields()的方法类似于执行查询SHOW COLUMNS FROM tbl_name [LIKE wild]。
注意，建议使用SHOW COLUMNS FROM tbl_name，而不是mysql_list_fields()。
必须用mysql_free_result()释放结果集。
返回值
如果成功，返回MYSQL_RES结果集。如果出现错误，返回NULL。
错误
· CR_COMMANDS_OUT_OF_SYNC
以不恰当的顺序执行了命令。
· CR_SERVER_GONE_ERROR
MySQL服务器不可用。
· CR_SERVER_LOST
在查询过程中，与服务器的连接丢失。
· CR_UNKNOWN_ERROR
出现未知错误。
MYSQL_RES *mysql_list_processes(MYSQL *mysql)
描述
返回描述当前服务器线程的结果集。该类信息与mysqladmin processlist或SHOW PROCESSLIST查询给出的信息相同。
必须用mysql_free_result()释放结果集。
返回值
如果成功，返回MYSQL_RES结果集。如果出现错误，返回NULL。
错误
· CR_COMMANDS_OUT_OF_SYNC
以不恰当的顺序执行了命令。
· CR_SERVER_GONE_ERROR
MySQL服务器不可用。
· CR_SERVER_LOST
在查询过程中，与服务器的连接丢失。
· CR_UNKNOWN_ERROR
出现未知错误。
MYSQL_RES *mysql_list_tables(MYSQL *mysql, const char *wild)
描述
返回由当前数据库内的表名组成的结果集，当前数据库与由通配符参数指定的简单正则表达式匹配。通配符参数可以包含通配符“%”或“_”，也可以是NULL指针，以便与所有的表匹配。调用mysql_list_tables()的方法类似于执行查询HOW tables [LIKE wild]。
必须用mysql_free_result()释放结果集。
返回值
如果成功，返回MYSQL_RES结果集。 如果出现错误，返回NULL。
错误
· CR_COMMANDS_OUT_OF_SYNC
以不恰当的顺序执行了命令。
· CR_SERVER_GONE_ERROR
MySQL服务器不可用。
· CR_SERVER_LOST
在查询过程中，与服务器的连接丢失。
· CR_UNKNOWN_ERROR
出现未知错误。
my_bool mysql_more_results(MYSQL *mysql)
描述
如果当前执行的查询存在多个结果，返回“真”，而且应用程序必须调用mysql_next_result()来获取结果。
返回值
如果存在多个结果，返回“真”（1），如果不存在多个结果，返回“假”（0）。
在大多数情况下，可调用mysql_next_result()来测试是否存在多个结果，如果存在多个结果，对检索进行初始化操作。
请参见25.2.9节，“多查询执行的C API处理”。请参见25.2.3.45节，“mysql_next_result()”。
错误
无。
int mysql_next_result(MYSQL *mysql)
描述
如果存在多个查询结果，mysql_next_result()将读取下一个查询结果，并将状态返回给应用程序。
如果前面的查询返回了结果集，必须为其调用mysql_free_result()。
调用了mysql_next_result()后，连接状态就像你已为下一查询调用了mysql_real_query()或mysql_query()时的一样。这意味着你能调用mysql_store_result()、mysql_warning_count()、mysql_affected_rows()等等。
如果mysql_next_result()返回错误，将不执行任何其他语句，也不会获取任何更多的结果，
返回值
|
返回值 |
描述 |
|
0 |
成功并有多个结果。 |
|
-1 |
成功但没有多个结果。 |
|
>0 |
出错 |
错误
· CR_COMMANDS_OUT_OF_SYNC
以不恰当的顺序执行了命令。例如，没有为前面的结果集调用mysql_use_result()。
· CR_SERVER_GONE_ERROR
MySQL服务器不可用。
· CR_SERVER_LOST
在查询过程中，与服务器的连接丢失。
· CR_UNKNOWN_ERROR
出现未知错误。
unsigned int mysql_num_fields(MYSQL_RES *result)
要想传递MYSQL*参量取而代之，请使用无符号整数mysql_field_count(MYSQL *mysql)。
描述
返回结果集中的行数。
注意，你可以从指向结果集的指针或指向连接句柄的指针获得行数。如果mysql_store_result()或mysql_use_result()返回NULL，应使用连接句柄（因而没有结果集指针）。在该情况下，可调用mysql_field_count()来判断mysql_store_result()是否生成了非空结果。这样，客户端程序就能采取恰当的行动，而不需要知道查询是否是SELECT语句（或类似SELECT的语句）。在下面的示例中，介绍了执行该操作的方式。
请参见25.2.13.1节，“为什么在mysql_query()返回成功后，mysql_store_result()有时会返回NULL”。
返回值
表示结果集中行数的无符号整数。
错误
无。
示例：
MYSQL_RES *result;unsigned int num_fields;unsigned int num_rows; if (mysql_query(&mysql,query_string)){ // error}else // query succeeded, process any data returned by it{ result = mysql_store_result(&mysql); if (result) // there are rows { num_fields = mysql_num_fields(result); // retrieve rows, then call mysql_free_result(result) } else // mysql_store_result() returned nothing; should it have? { if (mysql_errno(&mysql)) { fprintf(stderr, "Error: %s\n", mysql_error(&mysql)); } else if (mysql_field_count(&mysql) == 0) { // query does not return data // (it was not a SELECT) num_rows = mysql_affected_rows(&mysql); } }}
另一种可选方式是（如果你知道你的查询应返回结果集），使用检查“mysql_field_count(&mysql) is = 0”来替换mysql_errno(&mysql)调用。仅当出错时才应使用它。
my_ulonglong mysql_num_rows(MYSQL_RES *result)
描述
返回结果集中的行数。
mysql_num_rows()的使用取决于是否采用了mysql_store_result()或mysql_use_result()来返回结果集。如果使用了mysql_store_result()，可以立刻调用mysql_num_rows()。如果使用了mysql_use_result()，mysql_num_rows()不返回正确的值，直至检索了结果集中的所有行为止。
返回值
结果集中的行数。
错误
无。
int mysql_options(MYSQL *mysql, enum mysql_option option, const char *arg)
描述
可用于设置额外的连接选项，并影响连接的行为。可多次调用该函数来设置数个选项。
应在mysql_init()之后、以及mysql_connect()或mysql_real_connect()之前调用mysql_options()。
选项参量指的是你打算设置的选项。Arg参量是选项的值。如果选项是整数，那么arg应指向整数的值。
可能的选项值：
|
选项 |
参量类型 |
功能 |
|
MYSQL_INIT_COMMAND |
char * |
连接到MySQL服务器时将执行的命令。再次连接时将自动地再次执行。 |
|
MYSQL_OPT_COMPRESS |
未使用 |
使用压缩客户端／服务器协议 |
|
MYSQL_OPT_CONNECT_TIMEOUT |
unsigned int * |
以秒为单位的连接超时。 |
|
MYSQL_OPT_GUESS_CONNECTION |
未使用 |
对于与libmysqld链接的应用程序，允许库“猜测”是否使用嵌入式服务器或远程服务器。“猜测”表示，如果设置了主机名但不是本地主机，将使用远程服务器。该行为是默认行为。 可使用MYSQL_OPT_USE_EMBEDDED_CONNECTION 和MYSQL_OPT_USE_REMOTE_CONNECTION覆盖它。对于与libmysqlclient链接的应用程序，该选项将被忽略。 |
|
MYSQL_OPT_LOCAL_INFILE |
指向单元的可选指针 |
如果未给定指针，或指针指向“unsigned int != 0”，将允许命令LOAD LOCAL INFILE。 |
|
MYSQL_OPT_NAMED_PIPE |
未使用 |
使用命名管道连接到NT平台上的MySQL服务器。 |
|
MYSQL_OPT_PROTOCOL |
unsigned int * |
要使用的协议类型。应是mysql.h中定义的mysql_protocol_type的枚举值之一。 |
|
MYSQL_OPT_READ_TIMEOUT |
unsigned int * |
从服务器读取信息的超时（目前仅在Windows平台的TCP/IP连接上有效）。 |
|
MYSQL_OPT_RECONNECT |
my_bool * |
如果发现连接丢失，启动或禁止与服务器的自动再连接。从MySQL 5.0.3开始，默认情况下禁止再连接，这是5.0.13中的新选项，提供了一种以显式方式设置再连接行为的方法。 |
|
MYSQL_OPT_SET_CLIENT_IP |
char * |
对于与libmysqld链接的应用程序（具备鉴定支持特性的已编译libmysqld），它意味着，出于鉴定目的，用户将被视为从指定的IP地址（指定为字符串）进行连接。对于与libmysqlclient链接的应用程序，，该选项将被忽略。 |
|
MYSQL_OPT_USE_EMBEDDED_CONNECTION |
未使用 |
对于与libmysqld链接的应用程序，对于连接来说，它将强制使用嵌入式服务器。对于与libmysqlclient链接的应用程序，，该选项将被忽略。 |
|
MYSQL_OPT_USE_REMOTE_CONNECTION |
未使用 |
对于与libmysqld链接的应用程序，对于连接来说，它将强制使用远程服务器。对于与libmysqlclient链接的应用程序，，该选项将被忽略。 |
|
MYSQL_OPT_USE_RESULT |
未使用 |
不使用该选项。 |
|
MYSQL_OPT_WRITE_TIMEOUT |
unsigned int * |
写入服务器的超时（目前仅在Windows平台的TCP/IP连接上有效）。 |
|
MYSQL_READ_DEFAULT_FILE |
char * |
从命名选项文件而不是从my.cnf读取选项。 |
|
MYSQL_READ_DEFAULT_GROUP |
char * |
从my.cnf或用MYSQL_READ_DEFAULT_FILE指定的文件中的命名组读取选项。 |
|
MYSQL_REPORT_DATA_TRUNCATION |
my_bool * |
通过MYSQL_BIND.error，对于预处理语句，允许或禁止通报数据截断错误（默认为禁止）。 |
|
MYSQL_SECURE_AUTH |
my_bool* |
是否连接到不支持密码混编功能的服务器，在MySQL 4.1.1和更高版本中，使用了密码混编功能。 |
|
MYSQL_SET_CHARSET_DIR |
char* |
指向包含字符集定义文件的目录的路径名。 |
|
MYSQL_SET_CHARSET_NAME |
char* |
用作默认字符集的字符集的名称。 |
|
MYSQL_SHARED_MEMORY_BASE_NAME |
char* |
命名为与服务器进行通信的共享内存对象。应与你打算连接的mysqld服务器使用的选项“-shared-memory-base-name”相同。 |
注意，如果使用了MYSQL_READ_DEFAULT_FILE或MYSQL_READ_DEFAULT_GROUP，总会读取客户端组。
选项文件中指定的组可能包含下述选项：
|
选项 |
描述 |
|
connect-timeout |
以秒为单位的连接超时。在Linux平台上，该超时也用作等待服务器首次回应的时间。 |
|
compress |
使用压缩客户端／服务器协议。 |
|
database |
如果在连接命令中未指定数据库，连接到该数据库。 |
|
debug |
调试选项。 |
|
disable-local-infile |
禁止使用LOAD DATA LOCAL。 |
|
host |
默认主机名。 |
|
init-command |
连接到MySQL服务器时将执行的命令。再次连接时将自动地再次执行。 |
|
interactive-timeout |
等同于将CLIENT_INTERACTIVE指定为mysql_real_connect()。请参见25.2.3.51节，“mysql_real_connect()”。 |
|
local-infile[=(0|1)] |
如果无参量或参量!= 0，那么将允许使用LOAD DATA LOCAL。 |
|
max_allowed_packet |
客户端能够从服务器读取的最大信息包。 |
|
multi-results |
允许多语句执行或存储程序的多个结果集。 |
|
multi-statements |
允许客户端在1个字符串内发送多条语句。（由“;”隔开）。 |
|
password |
默认密码。 |
|
pipe |
使用命名管道连接到NT平台上的MySQL服务器。 |
|
protocol={TCP | SOCKET | PIPE | MEMORY} |
连接到服务器时将使用的协议。 |
|
port |
默认端口号。 |
|
return-found-rows |
通知mysql_info()返回发现的行，而不是使用UPDATE时更新的行。 |
|
shared-memory-base-name=name |
共享内存名称，用于连接到服务器（默认为"MYSQL"）。 |
|
socket |
默认的套接字文件。 |
|
user |
默认用户。 |
注意，“timeout”（超时）已被“connect-timeout”（连接超时）取代，但为了保持向后兼容，在MySQL 5.1.2-alpha中仍支持“timeout”（超时）。
关于选项文件的更多信息，请参见4.3.2节，“使用选项文件”。
返回值
成功时返回0。如果使用了未知选项，返回非0值。
示例：
MYSQL mysql; mysql_init(&mysql);mysql_options(&mysql,MYSQL_OPT_COMPRESS,0);mysql_options(&mysql,MYSQL_READ_DEFAULT_GROUP,"odbc");if (!mysql_real_connect(&mysql,"host","user","passwd","database",0,NULL,0)){ fprintf(stderr, "Failed to connect to database: Error: %s\n", mysql_error(&mysql));}
该代码请求客户端使用压缩客户端／服务器协议，并从my.cnf文件的obdc部分读取额外选项。
int mysql_ping(MYSQL *mysql)
描述
检查与服务器的连接是否工作。如果连接丢失，将自动尝试再连接。
该函数可被闲置了较长时间的客户端使用，用以检查服务器是否已关闭了连接，并在必要时再次连接。
返回值
如果与服务器的连接有效返回0。如果出现错误，返回非0值。返回的非0值不表示MySQL服务器本身是否已关闭，连接可能因其他原因终端，如网络问题等。
错误
· CR_COMMANDS_OUT_OF_SYNC
以不恰当的顺序执行了命令。
· CR_SERVER_GONE_ERROR
MySQL服务器不可用。
· CR_UNKNOWN_ERROR
出现未知错误。