mysql-fetch-row.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: ff4017b6334dae2d5353fe99df8089a828795324 Maintainer: HonestQiao Status: ready -->
<!-- CREDITS: mowangjuanzi, Luffy -->
<refentry xml:id="function.mysql-fetch-row" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
    <refname>mysql_fetch_row</refname>
    <refpurpose>从结果集中取得一行作为枚举数组</refpurpose>
 </refnamediv>

 <refsynopsisdiv>
  <warning>
   &mysql.alternative.note;
   <simplelist role="alternatives">
    <member><function>mysqli_fetch_row</function></member>
    <member>
     <methodname>PDOStatement::fetch</methodname>
     with <parameter>mode</parameter> as <constant>PDO::FETCH_NUM</constant>
    </member>
   </simplelist>
  </warning>
 </refsynopsisdiv>

 <refsect1 role="description">
  &reftitle.description;
     <methodsynopsis>
      <type>array</type><methodname>mysql_fetch_row</methodname>
      <methodparam><type>resource</type><parameter>result</parameter></methodparam>
     </methodsynopsis>
    <para>
     返回根据所取得的行生成的数组，如果没有更多行则返回 &false;。
    </para>
    <para>
     <function>mysql_fetch_row</function>
     从和指定的结果标识关联的结果集中取得一行数据并作为数组返回。每个结果的列储存在一个数组的单元中，偏移量从 0 开始。
    </para>
    <para>
     依次调用 <function>mysql_fetch_row</function>
     将返回结果集中的下一行，如果没有更多行则返回 &false;。
    </para>
    <para>
     参见 <function>mysql_fetch_array</function>，<function>mysql_fetch_assoc</function>，<function>mysql_fetch_object</function>，<function>mysql_data_seek</function>，<function>mysql_fetch_lengths</function> 和
     <function>mysql_result</function>。
    </para>
   </refsect1>

 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    &mysql.result.description;
   </variablelist>
  </para>
 </refsect1>

 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
   Returns an numerical array of strings that corresponds to the fetched row, or
   &false; if there are no more rows.
  </para>
  <para>
   <function>mysql_fetch_row</function> fetches one row of data from
   the result associated with the specified result identifier.  The
   row is returned as an array.  Each result column is stored in an
   array offset, starting at offset 0.
  </para>
 </refsect1>

 <refsect1 role="examples">
  &reftitle.examples;
  <para>
   <example>
    <title>Fetching one row with <function>mysql_fetch_row</function></title>
    <programlisting role="php">
<![CDATA[
<?php
$result = mysql_query("SELECT id,email FROM people WHERE id = '42'");
if (!$result) {
    echo 'Could not run query: ' . mysql_error();
    exit;
}
$row = mysql_fetch_row($result);

echo $row[0]; // 42
echo $row[1]; // the email value
?>
]]>
    </programlisting>
   </example>
  </para>
 </refsect1>

 <refsect1 role="notes">
  &reftitle.notes;
  &database.fetch-null;
 </refsect1>

 <refsect1 role="seealso">
  &reftitle.seealso;
  <para>
   <simplelist>
    <member><function>mysql_fetch_array</function></member>
    <member><function>mysql_fetch_assoc</function></member>
    <member><function>mysql_fetch_object</function></member>
    <member><function>mysql_data_seek</function></member>
    <member><function>mysql_fetch_lengths</function></member>
    <member><function>mysql_result</function></member>
   </simplelist>
  </para>
 </refsect1>
  </refentry>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->