php-doc-en/reference/msql/functions/msql-fetch-row.xml

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.5 $ -->
<refentry id="function.msql-fetch-row">
 <refnamediv>
  <refname>msql_fetch_row</refname>
  <refpurpose>Get row as enumerated array</refpurpose>
 </refnamediv>
 <refsect1>
  <title>Description</title>
  <methodsynopsis>
   <type>array</type><methodname>msql_fetch_row</methodname>
   <methodparam><type>resource</type><parameter>query_identifier</parameter></methodparam>
   <methodparam choice="opt"><type>int</type><parameter>result_type</parameter></methodparam>
  </methodsynopsis>
  <para>
   Returns an array that corresponds to the fetched row, or &false; if
   there are no more rows.
  </para>
  <para>
   <function>msql_fetch_row</function> fetches one row of data from
   the result associated with the specified query identifier.  The
   row is returned as an array.  Each result column is stored in an
   array offset, starting at offset 0.
  </para>  
  <para> 
   Subsequent call to <function>msql_fetch_row</function> would
   return the next row in the result set, or &false; if there are no
   more rows.
  </para>
  <para>
   The second optional argument <parameter>result_type</parameter>
   is a constant and can take the following values:
   <constant>MSQL_ASSOC</constant>, <constant>MSQL_NUM</constant>, and
   <constant>MSQL_BOTH</constant> with <constant>MSQL_NUM</constant> being
   the default.
  </para>
  <warning>
   <simpara>
    In PHP versions prior to 4.3.11 and 5.0.4 a bug existed
    when retrieving data from columns containing &null; values.
    Such columns were not placed into the resulting array.
   </simpara>
  </warning>
  <para>
   <example>
    <title><function>msql_fetch_row</function> example</title>
    <programlisting role="php">
<![CDATA[
<?php
$con = msql_connect();
if (!$con) {
    die('Server connection problem: ' . msql_error());
}

if (!msql_select_db('test', $con)) {
    die('Database connection problem: ' . msql_error());
}

$result = msql_query('SELECT id, name FROM people', $con);
if (!$result) {
    die('Query execution problem: ' . msql_error());
}

while ($row = msql_fetch_row($result)) {
    echo $row[0] . ': ' . $row[1] . "\n";
}

msql_free_result($result);
?>
]]>
    </programlisting>
   </example>
  </para>
  <para> 
   See also
   <function>msql_fetch_array</function>,
   <function>msql_fetch_object</function>,
   <function>msql_data_seek</function> and
   <function>msql_result</function>.
  </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:"../../../../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
-->