doc-fr/reference/ibm_db2/functions/db2-fetch-both.xml

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

<refentry xml:id="function.db2-fetch-both" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
  <refname>db2_fetch_both</refname>
  <refpurpose>
   Retourne un tableau, indexé par nom de colonne et position, représentant
   une ligne du jeu de résultats
  </refpurpose>
 </refnamediv>
 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <type>array</type><methodname>db2_fetch_both</methodname>
   <methodparam><type>resource</type><parameter>stmt</parameter></methodparam>
   <methodparam choice="opt"><type>int</type><parameter>row_number</parameter><initializer>-1</initializer></methodparam>
  </methodsynopsis>

  <para>
   Retourne un tableau, indexé par nom de colonne et position, représentant
   une ligne du jeu de résultats. Notez que la ligne retournée par
   <function>db2_fetch_both</function> nécessite plus de mémoire que les
   tableaux simplement indexés retournés par
   <function>db2_fetch_assoc</function> ou
   <function>db2_fetch_array</function>.
  </para>

 </refsect1>
 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    <varlistentry>
     <term><parameter>stmt</parameter></term>
     <listitem>
      <para>
       Une ressource <literal>stmt</literal> valide contenant le jeu de
       résultats.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>row_number</parameter></term>
     <listitem>
      <para>
       Demande une ligne spécifique indexée numériquement qui commence par la
       valeur 1 au jeu de résultat. En fournissant ce paramètre, vous
       obtiendrez une alerte PHP si le jeu de résultat
       utilise une curseur d'avancement seul.
      </para>
     </listitem>
    </varlistentry>
   </variablelist>
  </para>
 </refsect1>
 
 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
   Retourne un tableau associatif avec les valeurs des colonnes indexées par
   le nom des colonnes et le numéro des colonnes commençant par 0. Le tableau
   représente la ligne suivante ou la ligne demandée du jeu de résultats.
   Retourne &false; s'il n'y a pas de ligne disponible dans le jeu de
   résultats ou si la ligne demandée par <parameter>row_number</parameter>
   n'existe pas dans le jeu de résultats.
  </para>
 </refsect1>

 <refsect1 role="examples">
  &reftitle.examples;
  <para>
   <example>
    <title>Itère avec un curseur d'avancement seul</title>
    <para>
     Si vous appelez <function>db2_fetch_both</function> sans le numéro d'une
     ligne spécifique, la ligne suivante sera automatiquement récupérée par le
     jeu de résultats. L'exemple suivant accède aux colonnes retournées dans
     le tableau avec la méthode des noms de colonne et par indice numérique. 
    </para>
    <programlisting role="php">
<![CDATA[
<?php

$sql = "SELECT id, nom, race, poids FROM animaux ORDER BY race";
$stmt = db2_prepare($conn, $sql);
$result = db2_execute($stmt);

while ($row = db2_fetch_both($stmt)) {
    printf ("%-5d %-16s %-32s %10s\n", 
        $row['ID'], $row[0], $row['RACE'], $row[3]);
}
?>
]]>
    </programlisting>
    &example.outputs;
    <screen>
<![CDATA[
0     Pook             chat                                   3.20
5     Rickety Ride     chèvre                                 9.70
2     Smarty           cheval                               350.00
]]>
    </screen>
   </example>

   <example>
    <title>Récupération de lignes spécifiques avec <function>db2_fetch_both</function>
     provenant d'un curseur flottant</title>
    <para>
     Si votre jeu de résultats utilise un curseur flottant, vous pouvez
     appeler la fonction <function>db2_fetch_assoc</function> avec une numéro
     de ligne spécifique. L'exemple suivant récupère chaque ligne paire dans
     le jeu de résultats, commençant avec la deuxième ligne.
    </para>
    <programlisting role="php">
<![CDATA[
<?php

$sql = "SELECT id, nom, race, poids FROM animaux ORDER BY race";
$result = db2_exec($stmt, $sql, array('cursor' => DB2_SCROLLABLE));

$i=2;
while ($row = db2_fetch_both($result, $i)) {
    printf ("%-5d %-16s %-32s %10s\n", 
        $row[0], $row['NOM'], $row[2], $row['POIDS']);
    $i = $i + 2;
}
?>
]]>
    </programlisting>
    &example.outputs;
    <screen>
<![CDATA[
0     Pook             chat                                   3.20
5     Rickety Ride     chèvre                                 9.70
2     Smarty           cheval                               350.00
]]>
    </screen>
   </example>
  </para>
 </refsect1>

 <refsect1 role="seealso">
  &reftitle.seealso;
  <para>
   <simplelist>
    <member><function>db2_fetch_array</function></member>
    <member><function>db2_fetch_assoc</function></member>
    <member><function>db2_fetch_object</function></member>
    <member><function>db2_fetch_row</function></member>
    <member><function>db2_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
-->