php-doc-en/reference/mysql/functions/mysql-result.xml

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.8 $ -->
<!-- splitted from ./en/functions/mysql.xml, last change in rev 1.2 -->
<refentry id="function.mysql-result">
 <refnamediv>
  <refname>mysql_result</refname>
  <refpurpose>Get result data</refpurpose>
 </refnamediv>
 <refsect1>
  <title>Description</title>
   <methodsynopsis>
    <type>mixed</type><methodname>mysql_result</methodname>
    <methodparam><type>resource</type><parameter>result</parameter></methodparam>
    <methodparam><type>int</type><parameter>row</parameter></methodparam>
    <methodparam choice="opt"><type>mixed</type><parameter>
      field
     </parameter></methodparam>
   </methodsynopsis>
  <para>
   <function>mysql_result</function> returns the contents of one
   cell from a MySQL result set.  The field argument can be the
   field's offset, or the field's name, or the field's table dot
   field name (tablename.fieldname).  If the column name has been
   aliased ('select foo as bar from...'), use the alias instead of
   the column name.
  </para>
  <para>
   When working on large result sets, you should consider using one
   of the functions that fetch an entire row (specified below).  As
   these functions return the contents of multiple cells in one
   function call, they're MUCH quicker than
   <function>mysql_result</function>.  Also, note that specifying a
   numeric offset for the field argument is much quicker than
   specifying a fieldname or tablename.fieldname argument.
  </para>
  <para>
   Calls to <function>mysql_result</function> should not be mixed
   with calls to other functions that deal with the result set.
  </para>
  <para>
   <example>
    <title><function>mysql_result</function> example</title>
    <programlisting role="php">
<![CDATA[
<?php
$link = mysql_connect('localhost', 'mysql_user', 'mysql_password');
if (!$link) {
    die('Could not connect: ' . mysql_error());
}
$result = mysql_query('SELECT name FROM work.employee');
if (!$result) {
    die('Could not query:' . mysql_error());
}
echo mysql_result($result, 2); // outputs third employee's name

mysql_close($link);
?>
]]>
    </programlisting>
   </example>
  </para>
  <para>
   Recommended high-performance alternatives :
   <function>mysql_fetch_row</function>,
   <function>mysql_fetch_array</function>,
   <function>mysql_fetch_assoc</function> and
   <function>mysql_fetch_object</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
-->