第二十七章连接器和API

这里的例子使用GCC因为编译器。不同的编译器可能会在一些系统是合适的（例如，铿锵在OS X或FreeBSD，或阳光棚在Solaris）。调整的例子是必要的。

您可能需要指定一个-I选择当你编译客户端程序，使用mysql的头文件，以便编译器可以找到他们。例如，如果头文件安装在/usr/local／include mysql，在编译命令使用此选项：

-I/usr/local/mysql/include

MySQL客户端必须连接使用-lmysqlclient在“链接”命令选项。您可能还需要指定一个L选项告诉链接器在哪里找到图书馆。例如，如果库安装在/usr/local/mysql/lib在链接的命令，使用这些选项：

L /usr/local \ lmysqlclient MySQL / lib

路径名称可能不同在你的系统。调整-I和L备选办法

为了使它更容易编写UNIX MySQL程序，使用_配置MySQL脚本看到截面位置，”_配置MySQL-编制客户”显示选项

_配置MySQL显示编译或链接所需的选项：

shell> mysql_config --cflags
shell> mysql_config --libs

你可以运行这些命令得到正确的选项，手动添加到编译和链接命令。另外，包括输出_配置MySQL直接在命令行使用引号：

shell> gcc -c `mysql_config --cflags` progname.c
shell> gcc -o progname progname.o `mysql_config --libs`

在Unix系统中，使用默认的链接动态库。链接到静态客户端库相反，添加它的路径名链接命令。例如，如果图书馆位于/usr/local/mysql/lib这样，链接：

内核>gcc -o progname progname.o /usr/local/mysql/lib/libmysqlclient.a

或使用_配置MySQL提供图书馆的名字：

shell> gcc -o progname progname.o `mysql_config --variable=pkglibdir`/libmysqlclient.a

_配置MySQL目前不列出静态链接需要图书馆提供的一种方式，所以可能需要在链接命令附加的库的名称（例如，-lnsl -lsocket在Solaris）。要添加一个思想库，使用_配置MySQL库和LDD libmysqlclient.so（或otool L libmysqlclient.dylibOS X）

pkg-config可以用来作为一种替代_配置MySQL获取信息如编译器或链接库需要编译MySQL的应用。例如，以下对命令是等价的：

mysql_config --cflags
pkg-config --cflags mysqlclient

mysql_config --libs
pkg-config --libs mysqlclient

产生静态链接标志，使用此命令：

pkg-config --static --libs mysqlclient

有关更多信息，参见第27.7.4.2，“楼C API的客户端程序，使用pkg-config”

指定的头文件和库文件的位置，使用您的开发环境提供的设施。

建立C API的客户端在Windows，你必须在C的客户端库的链接，以及Windows ws2_32图书馆和图书馆secur32安全插座。

你把你的代码是动态的或静态的C++客户端库。在Windows中，静态库的命名mysqlclient.lib和动态库的命名libmysql.dll。此外，该libmysql.lib静态导入库是使用动态库需要。如果静态库是用C客户端，客户端应用程序必须与Visual Studio用来编译C++客户端库相同的版本编译（这是Visual Studio 2015年为静态C客户端库由Oracle）。

当使用Oracle的MySQL客户端库建立C（或MySQL连接器/ C），遵循这些规则的时候，你的客户端应用程序连接C运行库：

一般来说，当链接到一个静态MySQL C客户端库，客户端库和客户端应用程序必须使用相同的编译器选项时，链接的C运行时，如果你的C++客户端库编译的/MT选项，您的客户机应用程序也应该遵守/吨期权，等等（见在书店里写了一篇文章更多细节）。遵循这个规则，当你建立你自己的静态MySQL客户端库（或MySQL连接器C / C）从源和连接你的客户端应用它。

MySQL客户端库包括SSL支持内置。这是不必要的指定-lssl或- lcrypto在链接的时候。这样做可能会造成问题，在运行时。

如果链接器不能找到MySQL客户端库，你可能会得到符号开始与未定义的引用误差mysql_如表所示：

/甲氧苄啶/ ccfksdpa。阿`主要功能：/甲氧苄啶/ ccfksdpa。O（文本0xb）：对` mysql_init /甲氧苄啶/ ccfksdpa未定义的引用。O（文本0x31）：对` mysql_real_connect /甲氧苄啶/ ccfksdpa未定义的引用。O（文本0x69）：对` mysql_error“/甲氧苄啶/ ccfksdpa未定义的引用。O（文本0x9a）：对` mysql_close '未定义的引用

你应该能够通过增加解决这个问题-Ldir_path -lmysqlclient在你的链接命令结束，在那里dir_path代表路径的目录名的客户端库位于。要确定正确的目录，试试这个命令：

内核>mysql_config --libs

从输出_配置MySQL可能表明，应指定在链接命令以及其他图书馆。您可以包括_配置MySQL在你编译或链接命令使用引号直接输出。例如:

shell> gcc -o progname progname.o `mysql_config --libs`

如果错误发生在链接的时候，floor符号未定义，加入到数学库链接- LM到最后的编译/连接线。同样的，如果你要在你的系统中存在其他函数未定义的引用错误，如connect()，检查该函数的手册页中的问题来确定你应该添加到链接命令库。

如果你有未定义的引用错误，如不在你的系统中存在的功能，这通常意味着你的MySQL客户端库是一个系统，不是100%兼容你的编译：

mf_format.o(.text+0x201): undefined reference to `__lxstat'

在这种情况下，你应该下载最新的MySQL或连接器/ C源分布和编译MySQL客户端库自己。看到2.8节，从“源”安装MySQL，和MySQL连接器/ C开发指南

mysql_affected_rows()可执行语句后立即打电话mysql_query()或mysql_real_query()。它返回的行数的改变，删除或插入，最后一句好像是一个UPDATE，DELETE，或INSERT。为SELECT声明,mysql_affected_rows()就像mysql_num_rows()

为UPDATE语句所影响的行的值是默认的行数上的变化。如果您指定的client_found_rows国旗mysql_real_connect()当连接到mysqld，受影响的行的值的行数“建立“是的，相匹配；WHERE条款.

为REPLACE语句所影响的行的值是2，如果新排取代旧的行，因为在这种情况下，有一行被插入后的副本被删除。

为INSERT ... ON DUPLICATE KEY UPDATE语句所影响的行的值，每行1如果行插入新的一行，2如果现有的行被更新，0如果一个现有的行设置为其当前值。如果您指定的client_found_rows国旗，受影响的行的值为1（而不是0）如果一个现有的行设置为其当前值。

下面的一个CALL一个存储过程语句，mysql_affected_rows()返回，它将在程序执行的最后一个语句的值，或零如果这样的语句将返回-1。在程序中，你可以使用ROW_COUNT()在SQL级获得受影响的行的值对于个人陈述。

mysql_affected_rows()返回一个范围广泛的陈述一个有意义的值。详情见描述ROW_COUNT()进入12.14节，“信息功能”

一个大于零的整数，指示受影响的行数或检索。零表示没有记录被更新为一个UPDATE声明，不匹配的行哪里在查询或任何查询尚未执行的条款。1表示查询返回一个错误或者说，一个SELECT查询，mysql_affected_rows()之前打电话叫mysql_store_result()

因为mysql_affected_rows()返回一个无符号值，你可以检查1通过比较返回值我的最爱（或(my_ulonglong)~0等价，which is）。

无

char *stmt = "UPDATE products SET cost=cost*1.25
              WHERE group=10";
mysql_query(&mysql,stmt);
printf("%ld products updated",
       (long) mysql_affected_rows(&mysql));

如果设置自动提交模式mode1、如果模式0

零成功。非零，如果发生了一个错误。

无

改变指定的数据库用户和原因db成为默认的（电流）指定的数据库连接MySQL。在随后的查询，这个数据库是默认的表引用，包括没有明确的数据库名。

mysql_change_user()失败如果连接的用户不能通过认证或没有权限使用数据库。在这种情况下，用户和数据库都没有改变。

通过db参数无效的如果你不希望有一个默认的数据库。

此功能重置会话状态好像是做了一个新的连接和reauthenticated。（见第27.7.24，“C API自动重联控制”它总是执行。）ROLLBACK任何交易活跃，关闭掉所有的临时表，并开启所有的锁表。会议系统变量重置到相应的全局系统变量的值。准备好的语句释放HANDLER变量是封闭的。锁收购GET_LOCK()被释放。这些影响会发生，即使用户没有改变。

重置连接状态在一个更轻的方式没有改变用户的使用mysql_reset_connection()

零成功。非零，如果发生了一个错误。

同样的，你可以从mysql_real_connect()，加上：

if (mysql_change_user(&mysql, "user", "password", "new_database"))
{
   fprintf(stderr, "Failed to change user.  Error: %s\n",
           mysql_error(&mysql));
}

为当前连接返回默认字符集名称。

默认的字符集名称

无

关闭先前打开的连接mysql_close()同时释放连接句柄指向的MySQL如果处理程序是自动分配的mysql_init()或mysql_connect()

无

无

提交当前事务

这个功能的作用是本课题的价值completion_type系统变量。特别是，如果有价值completion_type是发布（2）、服务器进行发布终止交易后关闭客户端连接。呼叫mysql_close()从客户程序从客户端关闭连接。

零成功。非零，如果发生了一个错误。

无

此功能已过时。使用mysql_real_connect()相反

mysql_connect()尝试建立一个MySQL数据库引擎运行在连接主办mysql_connect()必须成功完成之前，你可以执行任何其他的API函数，除了mysql_get_client_info()

参数的含义是相同的相应参数mysql_real_connect()与不同的连接参数可以无效的。在这种情况下，C API的连接结构分配内存自动释放你叫mysql_close()。这种方法的缺点是不能如果连接失败检索错误信息。（从得到错误信息mysql_errno()或mysql_error()，你必须提供一个有效的MySQL用。）

一样的mysql_real_connect()

一样的mysql_real_connect()

创建数据库命名的db参数.

此功能已过时。使用mysql_query()发出一个SQLCREATE DATABASE语句

零成功。非零，如果发生了一个错误。

if(mysql_create_db(&mysql, "my_database"))
{
   fprintf(stderr, "Failed to create new database.  Error: %s\n",
           mysql_error(&mysql));
}

求任意排在查询结果集。这个offset价值是一个行数。指定的范围值零到mysql_num_rows(result)-1

此功能需要的结果集的结构包含查询的整个结果，所以mysql_data_seek()仅可用于结合mysql_store_result()，不mysql_use_result()

无

无

做一个DBUG_PUSH用给定的字符串mysql_debug()采用弗莱德鱼调试库。要使用此功能，您必须编写的客户端库支持调试。看到第28.5.3，“该计划”

无

无

电话在这里显示导致客户端库生成一个跟踪文件/tmp/client.trace在客户机：

_调试MySQL（T O / D：TMP / client.trace”）；

滴的数据库命名为db参数.

此功能已过时。使用mysql_query()发出一个SQLDROP DATABASE语句

零成功。非零，如果发生了一个错误。

if(mysql_drop_db(&mysql, "my_database"))
  fprintf(stderr, "Failed to drop the database: Error: %s\n",
          mysql_error(&mysql));

指示服务器写入调试信息错误日志。连接的用户必须有SUPER特权

零成功。非零，如果发生了一个错误。

此功能已过时mysql_errno()或mysql_error()可以用来代替

mysql_eof()确定一个结果集的最后一行被读取。

如果你得到一个结果集从一个成功的电话mysql_store_result()在一次操作中，客户端接收到完整的集。在这种情况下，一个无效的返回mysql_fetch_row()总是意味着结果集都已结束，这是不必要的电话mysql_eof()。当使用mysql_store_result()，mysql_eof()始终返回true

另一方面，如果你使用mysql_use_result()启动一个结果集检索，从服务器取得一个接一个打电话给你是组的行mysql_fetch_row()反复。因为发生在连接过程中可能的错误，一个无效的返回值mysql_fetch_row()不一定是结果集的最后达到正常。在这种情况下，你可以使用mysql_eof()确定发生了什么mysql_eof()返回一个非零值，如果结果集的最后达到零如果发生错误。

从历史上看，mysql_eof()在标准的MySQL错误功能mysql_errno()和mysql_error()。因为这些误差函数提供了相同的信息，它们的使用是首选mysql_eof()，这是不可取的。（事实上，他们提供了更多的信息，因为mysql_eof()只返回一个布尔值，而误差函数指示错误的原因时，一个发生。）

零成功。非零，如果结果集都已结束。

无

下面的示例演示如何使用mysql_eof()：

mysql_query(&mysql,"SELECT * FROM some_table");result = mysql_use_result(&mysql);while((row = mysql_fetch_row(result))){    // do something with data}if(!mysql_eof(result))  // mysql_fetch_row() failed due to an error{    fprintf(stderr, "Error: %s\n", mysql_error(&mysql));}

然而，你可以用标准的MySQL误差函数达到同样的效果：

mysql_query(&mysql,"SELECT * FROM some_table");
result = mysql_use_result(&mysql);
while((row = mysql_fetch_row(result)))
{
    // do something with data
}
if(mysql_errno(&mysql))  // mysql_fetch_row() failed due to an error
{
    fprintf(stderr, "Error: %s\n", mysql_error(&mysql));
}

指定的连接mysql，mysql_errno()返回最近调用的API函数，可以成功或失败，错误代码。一个零意味着没有发生错误返回值。客户端错误消息号在MySQL上市errmsg。H头文件。服务器错误消息号列mysqld_error.h。错误也列在附录B，错误，错误代码，及常见问题

MySQL特定的错误号返回mysql_errno()不同于SQLSTATE值返回mysql_sqlstate()。例如，在MySQL客户端程序显示错误使用下面的格式，在1146是的mysql_errno()价值和42s02’。”是相应的mysql_sqlstate()价值：

内核>SELECT * FROM no_such_table;错误1146（42s02）：表”测试。no_such_table”不存在

在过去的一个错误代码值mysql_xxx()电话，如果失败。零表示没有错误发生。

无

指定的连接mysql，mysql_error()返回一个空字符串包含最近调用API函数失败的错误信息。如果一个函数没有失败，返回值mysql_error()可能是以前的错误或显示没有错误空字符串。

一条经验法则是，所有的功能，必须要求服务器信息复位mysql_error()如果他们成功了

功能复位mysql_error()，两试验可用于检查错误：

如果（* mysql_error（和MySQL））{ //发生错误}如果（mysql_error（和MySQL）[ 0 ]）{ //发生错误}

客户的错误消息的语言可以通过重新编译MySQL客户端库的变化。你可以选择几种不同的语言错误消息。看到第4，“设置错误消息的语言”

一个null结尾的字符串，描述错误。如果没有错误发生，一个空字符串。

无

返回一个结果集作为一个列的定义MYSQL_FIELD结构。调用这个函数来检索结果中重复所有列设置信息。mysql_fetch_field()退货无效的当没有更多的领域是左。

元数据可选的连接，这个函数返回NULL当resultset_metadata系统变量设置为无。检查结果集的元数据，使用mysql_result_metadata()功能。有关管理结果集元数据转换的详细信息，参见第27.7.23，”C API的可选的结果集元数据

mysql_fetch_field()复位返回信息的第一场每次执行一个新的SELECT查询。外地回来的mysql_fetch_field()还受电话mysql_field_seek()

如果你叫mysql_query()执行SELECT桌上却没有叫mysql_store_result()，MySQL返回默认块长度（8KB）如果你打电话mysql_fetch_field()要求一个长度BLOB场。（对8KB大小是因为mysql不知道的最大长度为BLOB。这应该是可配置的时间。）一旦你检索结果集，max_length场>包含在特定查询此列的最大值的长度。

这个MYSQL_FIELD对于当前柱结构无效的如果没有列在左边或者如果结果集没有元数据。

无

MYSQL_FIELD *field;

while((field = mysql_fetch_field(result)))
{
    printf("field name %s\n", field->name);
}

给定一个场数fieldnr在结果集中的列，返回为列的字段定义mysql_field结构。使用此函数来检索任意列的定义。指定一个值fieldnr在范围从0mysql_num_fields(result)-1

元数据可选的连接，这个函数返回NULL当resultset_metadata系统变量设置为无。检查结果集的元数据，使用mysql_result_metadata()功能。有关管理结果集元数据转换的详细信息，参见第27.7.23，”C API的可选的结果集元数据

这个MYSQL_FIELD为指定的柱状结构无效的如果结果集没有元数据。

无

unsigned int num_fields;
unsigned int i;
MYSQL_FIELD *field;

num_fields = mysql_num_fields(result);
for(i = 0; i < num_fields; i++)
{
    field = mysql_fetch_field_direct(result, i);
    printf("Field %u is %s\n", i, field->name);
}

返回的数组MYSQL_FIELD结构的一个结果集。每个结构一列的结果集提供的字段定义。

元数据可选的连接，这个函数返回NULL当resultset_metadata系统变量设置为无。检查结果集的元数据，使用mysql_result_metadata()功能。有关管理结果集元数据转换的详细信息，参见第27.7.23，”C API的可选的结果集元数据

一个数组MYSQL_FIELD所有列的结果集的结构。无效的如果你没有结果集的元数据。

无

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);
}

返回当前行的列的长度在一个结果集。如果你打算复制字段的值，这个长度的信息也是很有用的优化，因为你可以避免调用strlen()。此外，如果结果集包含二进制数据，你必须使用此函数来确定数据的大小，因为strlen()返回不正确的结果的任何包含空字符字段。

空柱和柱的长度NULL值为零。如何区分这两种情况下，看到的描述mysql_fetch_row()

无符号的长整型表示每列的大小的数组（不包括任何终止null字节）。NULL如果发生了一个错误

mysql_fetch_lengths()只适用于当前行的结果集。它返回无效的如果你叫它之前调用mysql_fetch_row()或在检索结果的所有行。

MYSQL_ROW row;
unsigned long *lengths;
unsigned int num_fields;
unsigned int i;

row = mysql_fetch_row(result);
if (row)
{
    num_fields = mysql_num_fields(result);
    lengths = mysql_fetch_lengths(result);
    for(i = 0; i < num_fields; i++)
    {
         printf("Column %u is %lu bytes in length.\n",
                i, lengths[i]);
    }
}

检索结果集中的下一行。当使用后mysql_store_result()，mysql_fetch_row()退货无效的当没有更多的行检索。当使用后mysql_use_result()，mysql_fetch_row()退货无效的当没有更多的行检索或如果发生错误。

行中的值的数目是由mysql_num_fields(result)。如果行拥有从调用返回值mysql_fetch_row()的值，指针访问行[零]到row[mysql_num_fields(result)-1]无效的列中的值，以指示NULL指针

行中的字段值的长度可以通过调用mysql_fetch_lengths()。空字段和字段包含无效的都长0；你可以区分这些通过检查的字段值的指针。如果指针是NULL，场无效的；否则，该字段为空

一MYSQL_ROW为下一步的行结构无效的如果没有更多的行检索或如果发生错误。

错误不重之间的调用mysql_fetch_row()

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");
}

返回在连接最新查询的列数。

这一功能的正常使用时mysql_store_result()返回无效的（因此你没有结果集指针）。在这种情况下，你可以打电话mysql_field_count()如果您发现有错误，请尽管发表评论！mysql_store_result()要产生一个空的结果。这使客户端程序不知道查询是否是采取适当的行动SELECT（或SELECT一样的）声明。下面的例子说明了如何可以做到这。

看到第27.7.25.1，“为什么mysql_store_result()有时返回后mysql_query()返回成功”

一个无符号整数表示结果的列数集。

无

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_field_count(&mysql)电话mysql_errno(&mysql)。在这种情况下，你是直接从检查错误mysql_store_result()而不是根据价值mysql_field_count()是否声明了SELECT

设置为给定的字段偏移量的光标。下一个电话mysql_fetch_field()检索与补偿相关的列的字段定义。

寻找到一行的开头，通过offset值为零

这场光标的前一个值

无

返回用于近场光标的位置mysql_fetch_field()。这个值可以被用来作为一个参数mysql_field_seek()

田间的游标的当前偏移。

无

释放分配给一个结果集的存储mysql_store_result()，mysql_use_result()，mysql_list_dbs()，等等。当你做一个结果集，你必须释放内存使用要求mysql_free_result()

不要试图访问一个结果集后释放。

无

无

此功能提供了默认的客户端字符集信息。默认的字符集可能会改变的mysql_set_character_set()功能

这个例子表明，在现有的领域MY_CHARSET_INFO结构：

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+collation number: %d\n", cs.number);    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);}

返回一个字符串，表示MySQL客户端库版本；例如，"8.0.14"

功能价值是提供客户端库MySQL或连接器/ C版。有关更多信息，参见第27.7.4.5，“C API的服务器和客户端库的版本”

一个字符串，表示MySQL客户端库版本。

无

返回一个表示MySQL客户端库版本的整数。值的格式XYYZZ哪里X是专业版YY是释放水平（或次要版本），和ZZ在释放水平的子版：

major_version*10000 + release_level*100 + sub_version

例如,"8.0.14"返回八万零一十四

功能价值是提供客户端库MySQL或连接器/ C版。有关更多信息，参见第27.7.4.5，“C API的服务器和客户端库的版本”

一个表示MySQL客户端库版本的整数。

无

返回一个描述使用中的连接的类型的字符串，其中包括服务器主机名。

一个代表服务器主机名称和连接字符串类型。

无

返回一个选项可设置使用当前值mysql_options()。价值应被视为只读

这个option的说法是，你想要它的价值选择。这个精氨酸参数是一个指针指向的变量存储选项的值。arg必须是一个指针指向适当的变量的类型选项争论。下表显示了使用每个变量的类型option价值

零成功。非零如果有错误发生；出现这种情况option不可质疑的价值观

下面的调用测试MYSQL_OPT_RECONNECT选项在调用返回后成功的价值重新连接是真的还是假的指示是否启用自动重连。

bool reconnect;

if (mysql_get_option(mysql, MYSQL_OPT_RECONNECT, &reconnect))
  fprintf(stderr, "mysql_get_options() failed\n");

返回当前连接使用的协议版本。

一个无符号整数表示由当前连接使用的协议版本。

无

返回一个字符串，表示MySQL服务器版本；例如，"8.0.14"

一个字符串表示的MySQL服务器版本。

无

返回一个表示MySQL服务器版本的整数。值的格式XYYZZ哪里X是专业版YY是释放水平（或次要版本），和ZZ在释放水平的子版：

major_version*10000 + release_level*100 + sub_version

例如,"8.0.14"返回八万零一十四

这一功能的客户端程序，可用于确定是否存在一些特定版本的服务器性能。

一个表示MySQL服务器版本的整数。

无

mysql_get_ssl_cipher()返回用于指定连接到服务器的加密密码。MySQL是返回的连接处理mysql_init()

一个字符串命名连接用的密码，或NULL如果连接没有加密

这个函数创建使用SQL语句中的合法的SQL字符串。看到9.1.1节，“String Literals”

在字符串from论点是十六进制编码格式，每个字符编码为两个十六进制数字。结果是放在到的说法，随后终止null字节。

字符串所指向的from必须是长度字节。你必须分配to缓冲区是至少长×2 1字节。什么时候mysql_hex_string()Returns，the contents of到是一个空结束的字符串。返回值是编码的字符串的长度，不包括结束符null字节。

返回值可以被放置到使用SQL语句X'value'或0xvalue格式然而，返回值不包括“X”…或0x。调用方必须提供所需的任何人。

char query[1000],*end;

end = strmov(query,"INSERT INTO test_table values(");
end = strmov(end,"X'");
end += mysql_hex_string(end,"What is this",12);
end = strmov(end,"',X'");
end += mysql_hex_string(end,"binary data: \0\r\n",16);
end = strmov(end,"')");

if (mysql_real_query(&mysql,query,(unsigned int) (end - query)))
{
   fprintf(stderr, "Failed to insert row, Error: %s\n",
           mysql_error(&mysql));
}

这个strmov()在本例中使用的功能包括在libmysqlclient图书馆工作strcpy()但是，返回一个指向空结束的第一个参数。

编码的字符串的长度，放入to，不包括终止空字符

无

检索提供关于最近执行的语句的信息字符串，但只有这里列出的报表。其他报表，mysql_info()退货无效的。该字符串的格式取决于声明的类型，如下所述。数字只是说明；字符串包含值适当的语句。

mysql_info()返回一个非—无效的价值INSERT ... VALUES只为表的多行的形式（即，如果指定多个值列表）。

一个代表最近执行的语句的额外信息的字符串。NULL如果没有可用的信息的声明。

无

分配和初始化MYSQL适合对象mysql_real_connect()。如果MySQL是一个NULL指针的功能分配、初始化并返回一个新的对象。否则，对象被初始化的对象的地址返回。如果mysql_init()分配一个新的对象，它被释放时mysql_close()被称为关闭连接

在nonmultithreaded环境，mysql_init()调用mysql_library_init()自动是必要的。然而,mysql_library_init()在多线程环境中不是线程安全的，因此无论是mysql_init()。在调用mysql_init()，打打电话mysql_library_init()产卵前的任何线程，或者使用一个互斥体保护mysql_library_init()呼叫。这应该是任何其他的客户端库调用之前完成。

一个初始化的MYSQL*处理程序无效的如果没有足够的内存来分配一个新的对象。

在内存不足的情况，NULL返回

返回一个值的产生AUTO_INCREMENT由以前的列INSERT或UPDATE声明。使用这一功能，当你完成一个INSERT声明为一个表，包含一个汽车场，或使用INSERT或UPDATE设置列值LAST_INSERT_ID(expr)

返回值mysql_insert_id()总是零，除非明确更新以下条件：

返回值mysql_insert_id()可简化为以下序列：

mysql_insert_id()退货零如果前面的语句不使用AUTO_INCREMENT价值。如果你需要保存的值后，一定要打电话mysql_insert_id()生成价值声明后立即

价值mysql_insert_id()只有在当前客户端连接发布报表的影响。它不是由其他客户出具报表的影响。

这个LAST_INSERT_ID()SQL函数将包含第一个自动生成的值，成功插入。LAST_INSERT_ID()不复位陈述之间因为这个函数的值保存在服务器。另一个区别mysql_insert_id()是的，LAST_INSERT_ID()不更新如果您设置汽车列一个特定种类的价值。看到12.14节，“信息功能”

mysql_insert_id()退货零下面的一个CALL语句的存储过程生成汽车因为在这种情况下mysql_insert_id()适用于CALL而不是语句在程序。在程序中，你可以使用LAST_INSERT_ID()在SQL层面获得汽车价值

之间的差异的原因LAST_INSERT_ID()和mysql_insert_id()是的，LAST_INSERT_ID()是易于使用的脚本，mysql_insert_id()试图提供对发生什么更准确的信息汽车专栏

在前面的讨论

要求服务器杀死指定的线程pid

此功能已过时。使用mysql_query()发出一个SQLKILL语句

mysql_kill()不能处理值大于32位，但要警惕杀错线程返回一个错误，在这种情况下：

零成功。非零，如果发生了一个错误。

这个函数完成MySQL客户端库。把它当你使用完库（例如，从服务器断开连接后）。

使用的信息，参见第27.7.6，“C API函数概述”，和第27.7.7.41，“mysql_library_init()”

调用这个函数来初始化MySQL客户端库在你调用任何其他MySQL函数。

在nonmultithreaded环境，调用mysql_library_init()可以省略，因为mysql_init()将自动调用它时。然而,mysql_library_init()在多线程环境中不是线程安全的，因此无论是mysql_init()，这要求mysql_library_init()。你必须调用mysql_library_init()产卵前或其他任何线程，使用互斥锁保护的呼唤，你是否调用mysql_library_init()或间接通过mysql_init()。任何其他的客户端库调用之前做这个。

这个argc，argv，和groups争论是无用的。在旧的版本，它们被用来连接的嵌入式服务器应用程序，它不再支持。电话现在应该写成mysql_library_init(0, NULL, NULL)

#include <mysql.h>#include <stdlib.h>int main(void) {  if (mysql_library_init(0, NULL, NULL)) {    fprintf(stderr, "could not initialize MySQL client library\n");    exit(1);  }  /* Use any MySQL API functions here */  mysql_library_end();  return EXIT_SUCCESS;}

零成功。非零，如果发生了一个错误。

返回一个结果集包含在服务器，简单的正则表达式匹配指定的数据库名称wild参数.野生的可以包含通配符%或_，或可能是一个NULL匹配所有数据库指针。打电话mysql_list_dbs()类似于执行查询显示数据库[喜欢wild]

你必须自由的结果集mysql_free_result()

一MYSQL_RES为成功的结果集无效的如果发生了一个错误

返回一个空结果集的元数据提供有关栏目信息在给定的表相匹配的简单的正则表达式指定的wild参数.野生的可以包含通配符%或_，或可能是一个NULL匹配所有字段的指针。打电话mysql_list_fields()类似于执行查询显示列tbl_name喜欢wild]

最好使用SHOW COLUMNS FROM tbl_name而不是mysql_list_fields()

你必须自由的结果集mysql_free_result()

一MYSQL_RES为成功的结果集无效的如果发生了一个错误

int i;
MYSQL_RES *tbl_cols = mysql_list_fields(mysql, "mytbl", "f%");

unsigned int field_cnt = mysql_num_fields(tbl_cols);
printf("Number of columns: %d\n", field_cnt);

for (i=0; i < field_cnt; ++i)
{
  /* col describes i-th column of the table */
  MYSQL_FIELD *col = mysql_fetch_field_direct(tbl_cols, i);
  printf ("Column %d: %s\n", i, col->name);
}
mysql_free_result(tbl_cols);

返回一个结果集，描述了当前服务器的线程。这是一种信息报道mysqladmin processlist或SHOW PROCESSLIST查询

你必须自由的结果集mysql_free_result()

一MYSQL_RES为成功的结果集无效的如果发生了一个错误

返回一个结果集包含在当前数据库的简单的正则表达式匹配指定的表名wild参数.野生的可以包含通配符%或_，或可能是一个NULL匹配所有表的指针。打电话mysql_list_tables()类似于执行查询显示表[喜欢wild]

你必须自由的结果集mysql_free_result()

一MYSQL_RES为成功的结果集无效的如果发生了一个错误

使用此功能，当你执行多个语句指定为单个语句的字符串，或当你执行CALL报表，可以返回多个结果集。

mysql_more_results()如果更多的结果，从目前执行的语句的真实存在，在这种情况下，应用程序必须调用mysql_next_result()取结果

TRUE（1）如果存在更多的结果。错误的（0）如果没有结果的存在。

在大多数情况下，你可以打电话mysql_next_result()相反，测试是否存在更多的结果如果是这样开始检索。

看到第27.7.19，“C API多语句执行的支持”，和第27.7.7.47，“mysql_next_result()”

无

使用此功能，当你执行多个语句指定为单个语句的字符串，或当您使用CALL语句执行存储过程，可以返回多个结果集。

mysql_next_result()读取下一个语句的结果并返回一个状态指示是否存在更多的结果。如果mysql_next_result()返回一个错误，没有结果。

在每次调用mysql_next_result()，你必须调用mysql_free_result()对于目前的声明，如果它是一个语句，返回一个结果集（而不仅仅是一个结果状态）。

在调用mysql_next_result()连接的状态，如果你叫了mysql_real_query()或mysql_query()在接下来的声明。这意味着你可以打电话mysql_store_result()，mysql_warning_count()，mysql_affected_rows()第四，”

如果你的程序使用CALL语句执行存储过程的client_multi_results国旗必须启用。这是因为每个CALL返回一个结果显示呼叫状态，除了可能在程序执行的语句返回的结果集。因为CALL可以返回多个结果，使用循环调用它们的过程mysql_next_result()以确定是否有更多的结果。

CLIENT_MULTI_RESULTS可以使你打电话时mysql_real_connect()，直接通过client_multi_results标志本身，或隐式地通过CLIENT_MULTI_STATEMENTS（这也使client_multi_results）CLIENT_MULTI_RESULTS默认情况下启用

它也可以检测是否有更多的结果，通过调用mysql_more_results()。然而，这个函数不改变连接状态，所以如果它返回true，你仍然必须调用mysql_next_result()前进到下一个结果

为例，说明如何使用mysql_next_result()，看到第27.7.19，“C API多语句执行的支持”