manual_clients.html

详细介绍了MYSQL的主要功能几一些代码

<h3><a NAME="mysql_field_seek" HREF="manual_toc.html#mysql_field_seek">20.4.20<code> 
mysql_field_seek()</code></a></h3>

<p><code>MYSQL_FIELD_OFFSET mysql_field_seek(MYSQL_RES *result, MYSQL_FIELD_OFFSET offset)</code> 
</p>

<h4>20.4.20.1 说明</h4>

<p>将字段光标设置到给定的偏移量。下一次调用<code>mysql_fetch_field()</code>将检索与该偏移量关联的列的字段定义。 
</p>

<p>为了定位于行的起始，传递一个值为0的<code>offset</code>值。 </p>

<h4>20.4.20.2 返回值</h4>

<p>字段光标的先前的值。 </p>

<h4>20.4.20.3 错误</h4>

<p>无。 </p>

<p><a NAME="IDX743"></a> </p>

<h3><a NAME="mysql_field_tell" HREF="manual_toc.html#mysql_field_tell">20.4.21<code>mysql_field_tell()</code></a></h3>

<p><code>MYSQL_FIELD_OFFSET mysql_field_tell(MYSQL_RES *result)</code> </p>

<h4>20.4.21.1 说明</h4>

<p>返回用于最后一个<code>mysql_fetch_field()</code>的字段光标的位置。这个值可用作<code>mysql_field_seek()</code>的一个参数。 
</p>

<h4>20.4.21.2 返回值</h4>

<p>字段光标的当前偏移量。 </p>

<h4>20.4.21.3 错误</h4>

<p>无。 </p>

<p><a NAME="IDX744"></a> </p>

<h3><a NAME="mysql_free_result" HREF="manual_toc.html#mysql_free_result">20.4.22<code> 
mysql_free_result()</code></a></h3>

<p><code>void mysql_free_result(MYSQL_RES *result)</code> </p>

<h4>20.4.22.1 说明</h4>

<p>释放由<code>mysql_store_result()</code>、<code>mysql_use_result()</code>、mysql_list_dbs()等为一个结果集合分配的内存。当你用完了一个结果集合时，你必须调用<code>mysql_free_result()</code>来释放它使用的内存。</p>

<h4>20.4.22.2 返回值</h4>

<p>无。 </p>

<h4>20.4.22.3 错误</h4>

<p>无。 </p>

<p><a NAME="IDX745"></a> </p>

<h3><a NAME="mysql_get_client_info" HREF="manual_toc.html#mysql_get_client_info">20.4.23<code> 
mysql_get_client_info()</code></a></h3>

<p><code>char *mysql_get_client_info(void)</code> </p>

<h4>20.4.23.1 说明</h4>

<p>返回代表客户库的版本的字符串。 </p>

<h4>20.4.23.2 返回值</h4>

<p>代表<strong>MySQL</strong>客户库版本的一个字符串。</p>

<h4>20.4.23.3 错误</h4>

<p>无。 </p>

<p><a NAME="IDX746"></a> </p>

<h3><a NAME="mysql_get_host_info" HREF="manual_toc.html#mysql_get_host_info">20.4.24<code> 
mysql_get_host_info()</code></a></h3>

<p><code>char *mysql_get_host_info(MYSQL *mysql)</code> </p>

<h4>20.4.24.1 说明</h4>

<p>返回描述正在使用的连接类型的字符串，包括服务其主机名。 </p>

<h4>20.4.24.2 返回值</h4>

<p>表示服务器主机名者和连接类型的字符串。 </p>

<h4>20.4.24.3 错误</h4>

<p>无。</p>

<p>　</p>

<h3><a NAME="mysql_get_proto_info" HREF="manual_toc.html#mysql_get_proto_info">20.4.25<code> 
mysql_get_proto_info()</code></a></h3>

<p><code>unsigned int mysql_get_proto_info(MYSQL *mysql)</code> </p>

<h4>20.4.25.1 说明</h4>

<p>返回当前连接使用的协议版本。 </p>

<h4>20.4.25.2 返回值</h4>

<p>表示被当前连接使用的协议版本的一个无符号整数。 </p>

<h4>20.4.25.3 错误</h4>

<p>无。 </p>

<p><a NAME="IDX748"></a> </p>

<h3><a NAME="mysql_get_server_info" HREF="manual_toc.html#mysql_get_server_info">20.4.26<code> 
mysql_get_server_info()</code></a></h3>

<p><code>char *mysql_get_server_info(MYSQL *mysql)</code> </p>

<h4>20.4.26.1 说明</h4>

<p>返回表示服务器版本号的字符串。 </p>

<h4>20.4.26.2 返回值</h4>

<p>表示服务器版本号的一个字符串。 </p>

<h4>20.4.26.3 错误</h4>

<p>无。 </p>

<p><a NAME="IDX749"></a> </p>

<h3><a NAME="mysql_info" HREF="manual_toc.html#mysql_info">20.4.27<code> mysql_info()</code></a></h3>

<p><code>char *mysql_info(MYSQL *mysql)</code> </p>

<h4>20.4.27.1 说明</h4>

<p>检索一个字符串，它提供有关最近执行的查询的信息，但是对下面列出的语句。对其他语句，<code>mysql_info()</code>返回<code>NULL</code>。字符串的格式随查询类型而变化，如下所述。数字仅仅是说明性的；字符串将包含对查询适当的值。 

<dl COMPACT="mysql_info">
  <dt><code>INSERT INTO ... SELECT ...</code> </dt>
  <dd>字符串格式： <code>Records: 100 Duplicates: 0 Warnings: 0</code> </dd>
  <dt><code>INSERT INTO ... VALUES (...),(...),(...)...</code> </dt>
  <dd>字符串格式： <code>Records: 3 Duplicates: 0 Warnings: 0</code> </dd>
  <dt><code>LOAD DATA INFILE ...</code> </dt>
  <dd>字符串格式： <code>Records: 1 Deleted: 0 Skipped: 0 Warnings: 0</code> </dd>
  <dt><code>ALTER TABLE</code> </dt>
  <dd>字符串绳格式： <code>Records: 3 Duplicates: 0 Warnings: 0</code> </dd>
  <dt><code>UPDATE</code> </dt>
  <dd>字符串格式： <code>Rows matched: 40 Changed: 40 Warnings: 0</code> </dd>
</dl>

<p>注意，只有多个值在语句中指定，<code>mysql_info()</code>对<code>INSERT 
... VALUES</code>语句才返回非<code>NULL</code>值。 </p>

<h4>20.4.27.2 返回值</h4>

<p>表示最近执行的查询的附加信息的一个字符串。如果得不到查询的任何信息，<code>NULL。</code></p>

<h4>20.4.27.3 错误</h4>

<p>无。 </p>

<p><a NAME="IDX750"></a> </p>

<h3><a NAME="mysql_init" HREF="manual_toc.html#mysql_init">20.4.28<code> mysql_init()</code></a></h3>

<p><code>MYSQL *mysql_init(MYSQL *mysql)</code> </p>

<h4>20.4.28.1 说明</h4>

<p>分配或初始化适合<code>mysql_real_connect()</code>的一个<code>MYSQL</code>对象。如果<code>mysql</code>是一个<code>NULL</code>指针，函数分配、初始化并且返回一个新对象。否则对象被初始化并且返回对象的地址。如果<code>mysql_init()</code>分配一个新对象，它将在调用<code>mysql_close()</code>关闭连接时被释放。</p>

<h4>20.4.28.2 返回值</h4>

<p>一个被初始化的<code>MYSQL*</code>句柄。如果没有足够的内存来分配一个新对象，<code>NULL</code>。</p>

<h4>20.4.28.3 错误</h4>

<p>在内存不够的情况下，返回<code>NULL</code>。</p>

<p><a NAME="IDX751"></a> </p>

<h3><a NAME="mysql_insert_id" HREF="manual_toc.html#mysql_insert_id">20.4.29<code> 
mysql_insert_id()</code></a></h3>

<p><code>my_ulonglong mysql_insert_id(MYSQL *mysql)</code> </p>

<h4>20.4.29.1 说明</h4>

<p>返回由先前的查询为一个<code>AUTO_INCREMENT</code>列生成的ID。在你执行一个<code>INSERT</code>查询向一个包含<code>AUTO_INCREMENT</code>字段的表中插入后，使用这个函数。</p>

<p>注意，如果先前的查询不产生一个<code>AUTO_INCREMENT</code>值，<code>mysql_insert_id()</code>返回<code>0</code>。如果你需要在以后保存该值，必须在查询生成了该值后马上调用<code>mysql_insert_id()</code>。</p>

<p>也要注意，SQL的<code>LAST_INSERT_ID()</code>函数总是包含最近生成的<code>AUTO_INCREMENT</code>值，并且在查询之间不被重置，因为该函数的值在服务器端维护。 
</p>

<h4>20.4.29.2 返回值</h4>

<p>有先前的查询更新的<code>AUTO_INCREMENT</code>字段的值。如果在连接上没有先前的询问或如果查询没更新<code>AUTO_INCREMENT</code>值，返回零。</p>

<h4>20.4.29.3 错误</h4>

<p>无。 </p>

<p><a NAME="IDX752"></a> </p>

<h3><a NAME="mysql_kill" HREF="manual_toc.html#mysql_kill">20.4.30<code> mysql_kill()</code></a></h3>

<p><code>int mysql_kill(MYSQL *mysql, unsigned long pid)</code> </p>

<h4>20.4.30.1 说明</h4>

<p>要求服务器杀死由<code>pid</code>指定的线程。 </p>

<h4>20.4.30.2 返回值</h4>

<p>成功，零。如果出现一个错误，非零。 </p>

<h4>20.4.30.3 错误</h4>

<dl COMPACT="mysql_kill">
  <dt><code>CR_COMMANDS_OUT_OF_SYNC</code> </dt>
  <dd>命令以一个不正确的次序被执行。 </dd>
  <dt><code>CR_SERVER_GONE_ERROR</code> </dt>
  <dd><strong>MySQL</strong>服务器关闭了。 </dd>
  <dt><code>CR_SERVER_LOST</code> </dt>
  <dd>对服务器的连接在查询期间失去。 </dd>
  <dt><code>CR_UNKNOWN_ERROR</code> </dt>
  <dd>发生一个未知的错误。 </dd>
</dl>

<p>　</p>

<h3><a NAME="mysql_list_dbs" HREF="manual_toc.html#mysql_list_dbs">20.4.31<code> 
mysql_list_dbs()</code></a></h3>

<p><code>MYSQL_RES *mysql_list_dbs(MYSQL *mysql, const char *wild)</code> </p>

<h4>20.4.31.1 说明</h4>

<p>返回一个结果集合，它用在服务器上的匹配<code>wild</code>参数指定的简单正则表达式的数据库名组成。<code>wild</code>可以包含通配符字符<samp>“%”</samp>或<samp>“_”</samp>，或可以是匹配所有的数据库的一个<code>NULL</code>指针。调用<code>mysql_list_dbs()</code>类似于执行查询<code>SHOW 
databases [LIKE wild]</code>。</p>

<p>你必须用<code>mysql_free_result()</code>释放结果集合。 </p>

<h4>20.4.31.2 返回值</h4>

<p>成功，一个<code>MYSQL_RES</code>结果集合。如果出现一个错误，<code>NULL。</code></p>

<h4>20.4.31.3 错误</h4>

<dl COMPACT="mysql_list_dbs">
  <dt><code>CR_COMMANDS_OUT_OF_SYNC</code> </dt>
  <dd>命令以一个不正确的次序被执行。 </dd>
  <dt><code>CR_OUT_OF_MEMORY</code> </dt>
  <dd>内存溢出。 </dd>
  <dt><code>CR_SERVER_GONE_ERROR</code> </dt>
  <dd><strong>MySQL</strong>服务器关闭了。 </dd>
  <dt><code>CR_SERVER_LOST</code> </dt>
  <dd>对服务器的连接在查询期间失去。 </dd>
  <dt><code>CR_UNKNOWN_ERROR</code> </dt>
  <dd>发生一个未知的错误。 </dd>
</dl>

<p>　</p>

<h3><a NAME="mysql_list_fields" HREF="manual_toc.html#mysql_list_fields">20.4.32<code> 
mysql_list_fields()</code></a></h3>

<p><code>MYSQL_RES *mysql_list_fields(MYSQL *mysql, const char *table, const char *wild)</code> 
</p>

<h4>20.4.32.1 说明</h4>

<p>返回一个结果集合，它用在给定表中的匹配<code>wild</code>参数指定的简单正则表达式的列名组成。<code>wild</code>可以包含通配符字符<samp>“%”</samp>或<samp>“_”</samp>，或可以是匹配所有列的一个<code>NULL</code>指针。调用<code>mysql_list_fields()</code>类似于执行查询<code>SHOW 
COLUMNS FROM tbl_name [LIKE wild]</code>。</p>

<p>注意，建议你使用<code>SHOW COLUMNS FROM tbl_name</code>而不是<code>mysql_list_fields()</code>。</p>

<p>你必须用<code>mysql_free_result()</code>释放结果集合。</p>

<h4>20.4.32.2 返回值</h4>

<p>成功，一个<code>MYSQL_RES</code>的结果集合。如果出线一个错误，<code>NULL。</code></p>

<h4>20.4.32.3 错误</h4>

<dl COMPACT="mysql_list_fields">
  <dt><code>CR_COMMANDS_OUT_OF_SYNC</code> </dt>
  <dd>命令以一个不正确的次序