doc-fr/reference/mysql/functions/mysql-result.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: e41806c30bf6975e452c0d4ce35ab0984c2fa68c Maintainer: yannick Status: ready -->
<!-- Reviewed: yes -->

<refentry xml:id="function.mysql-result" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
  <refname>mysql_result</refname>
  <refpurpose>Retourne un champ d'un résultat MySQL</refpurpose>
 </refnamediv>

 <refsynopsisdiv>
  <warning>
   &mysql.alternative.note;
   <simplelist role="alternatives">
    <member>
     <function>mysqli_data_seek</function> en conjonction de
     <function>mysqli_field_seek</function> et
     <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>
   Retourne le contenu d'un champ d'un jeu de résultats MySQL.
  </para>
  <para>
   Lorsque vous travaillez sur des résultats de grande taille,
   il est conseillé d'utiliser une des fonctions qui vont rechercher une ligne
   entière dans un tableau. Ces fonctions sont NETTEMENT plus
   rapides. De plus, utiliser un offset numérique est
   aussi beaucoup plus rapide que spécifier un nom littéral.
  </para>
 </refsect1>

 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    &mysql.result.description;
    <varlistentry>
     <term><parameter>row</parameter></term>
     <listitem>
      <para>
       Le numéro de la ligne à récupérer. Les numéros de lignes commencent à
       &zero;.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>field</parameter></term>
     <listitem>
      <para>
       Le nom ou la position du champ à récupérer.
      </para>
      <para>
       Il peut être la position du champ, le nom du champ ou le nom de 
       la table suivi d'un point, suivi du nom du champ 
       (<literal>tablename.fieldname</literal>).
       Si un alias a été utilisé pour le nom de la colonne 
       (<literal>"selected foo as bar from..."</literal>),
       utilisez plutôt l'alias. Si ce paramètre n'est pas défini, le premier champ
       sera récupéré.
      </para>
     </listitem>
    </varlistentry>
   </variablelist>
  </para>
 </refsect1>
 
 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
   Le contenu d'un champ depuis un jeu de résultats MySQL en cas
   de succès, ou &false; si une erreur survient.
  </para>
 </refsect1>

 <refsect1 role="examples">
  &reftitle.examples;
  <para>
   <example>
    <title>Exemple avec <function>mysql_result</function></title>
    <programlisting role="php">
<![CDATA[
<?php
$link = mysql_connect('localhost', 'mysql_user', 'mysql_password');
if (!$link) {
   die('Impossible de se connecter : ' . mysql_error());
}
if (!mysql_select_db('database_name')) {
    die('Impossible de sélectionner la table : ' . mysql_error());
}
$result = mysql_query('SELECT name FROM work.employee');
if (!$result) {
   die('Impossible d\'exécuter la requête :' . mysql_error());
}
echo mysql_result($result, 2); // Affiche le nom du troisième employé

mysql_close($link);
?>
]]>
    </programlisting>
   </example>
  </para>
 </refsect1>

 <refsect1 role="notes">
  &reftitle.notes;
  <note>
   <para>
    Les appels <function>mysql_result</function> ne devraient pas être
    mélangés avec d'autres fonctions qui travaillent aussi sur
    le résultat.
   </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
-->