mysql-result.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: e41806c30bf6975e452c0d4ce35ab0984c2fa68c Maintainer: yago Status: ready -->
<!-- Reviewed: yes Maintainer: seros -->
<refentry xml:id="function.mysql-result" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
  <refname>mysql_result</refname>
  <refpurpose>Obtener datos de resultado</refpurpose>
 </refnamediv>
 
 <refsynopsisdiv>
  <warning>
   &mysql.alternative.note;
   <simplelist role="alternatives">
    <member>
     <function>mysqli_data_seek</function> junto con
     <function>mysqli_field_seek</function> y
     <function>mysqli_fetch_field</function>
    </member>
    <member><methodname>PDOStatement::fetchColumn</methodname></member>
   </simplelist>
  </warning>
 </refsynopsisdiv>
 
 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <type>string</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><initializer>0</initializer></methodparam>
  </methodsynopsis>
  <para>
   Recupera el contenido de una celda de un conjunto de resultados de MySQL.
  </para>
  <para>
   Cuando se esté trabajando con conjuntos de resultados grandes, se debería considerar usar una
   de las funciones que obtienen una fila completa (especificadas más abajo). Debido a que
   estas funciones retornan el contenido de múltiples celdas en una única
   llamada a función, son MUCHO MÁS rápidas que
   <function>mysql_result</function>. Además, se ha de tener en cuenta que la especificación
   de un índice numérico para el campo pasado como argumento es mucho más rápido que
   especificar un nombre de campo o el argumento nombre_tabla.nombre_campo.
  </para>
 </refsect1>
 
 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    &mysql.result.description;
    <varlistentry>
     <term><parameter>row</parameter></term>
     <listitem>
      <para>
       El número de fila del conjunto de resultados que está siendo recuperado. El número de filas
       empieza a partir de <literal>0</literal>.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>field</parameter></term>
     <listitem>
      <para>
       El nombre o el índice del campo que está siendo recuperado.
      </para>
      <para>
       Puede ser el índice del campo, el nombre del campo, o el nombre de la tabla 
       punto nombre del campo (nombre_tabla.nombre_campo). Si se ha utilizado un alias
       para el nombre de la columna ('select foo as bar from...'), utilice el alias en lugar
       del nombre del campo. Si no está definido, se recuperará el primer campo.
      </para>
     </listitem>
    </varlistentry>
   </variablelist>
  </para>
 </refsect1>
 
 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
   El contenido de una celda de un conjunto de resultados de MySQL en caso de éxito, o 
   &false; en caso de fallo.
  </para>
 </refsect1>
 
 <refsect1 role="examples">
  &reftitle.examples;
  <para>
   <example>
    <title>Ejemplo de <function>mysql_result</function></title>
    <programlisting role="php">
<![CDATA[
<?php
$enlace = mysql_connect('anfitrión_mysql', 'usuario_mysql', 'contraseña_mysql');
if (!$enlace) {
    die('No se pudo conectar: ' . mysql_error());
}
if (!mysql_select_db('nombre_base_datos')) {
    die('No se pudo seleccionar la base de datos: ' . mysql_error());
}
$resultado = mysql_query('SELECT name FROM work.employee');
if (!$resultado) {
    die('No se pudo consultar:' . mysql_error());
}
echo mysql_result($resultado, 2); // imprime el nombre del tercer empleado

mysql_close($enlace);
?>
]]>
    </programlisting>
   </example>
  </para>
 </refsect1>
 
 <refsect1 role="notes">
  &reftitle.notes;
  <note>
   <para>
    Las llamadas a <function>mysql_result</function> no deberían ser mezcladas
    con llamadas a otras funciones que manejen conjuntos de resultados.
   </para>
  </note>
 </refsect1>
 
 <refsect1 role="seealso">
  &reftitle.seealso;
  <para>
   <simplelist>
    <member><function>mysql_fetch_row</function></member>
    <member><function>mysql_fetch_array</function></member>
    <member><function>mysql_fetch_assoc</function></member>
    <member><function>mysql_fetch_object</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
-->