doc-fr/reference/maxdb/functions/maxdb-fetch-array.xml

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.9 $ -->
<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready -->
<!-- Reviewed: no -->

<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.maxdb-fetch-array">
 <refnamediv>
  <refname>maxdb_fetch_array</refname>
  <refname>result->fetch_array</refname>
  <refpurpose>Récupère une ligne de résultat dans un tableau numérique, associatif ou les deux</refpurpose>
 </refnamediv>

 <refsect1 role="description">
  &reftitle.description;
  <para>Style procédural :</para>
  <methodsynopsis>
   <type>mixed</type><methodname>maxdb_fetch_array</methodname>
   <methodparam><type>resource</type><parameter>result</parameter></methodparam>
   <methodparam choice='opt'><type>int</type><parameter>resulttype</parameter></methodparam>
  </methodsynopsis>
  <para>Style orienté objet (méthode) :</para>
  <classsynopsis>
   <ooclass><classname>result</classname></ooclass>
   <methodsynopsis>
    <type>mixed</type>
    <methodname>fetch_array</methodname>
    <methodparam choice='opt'><type>int</type><parameter>resulttype</parameter></methodparam>
   </methodsynopsis>
  </classsynopsis>
  <para>
   Retourne un tableau qui correspond à la ligne récupérée ou
   &null; s'il n'y a plus de lignes pour le jeu de résultats
   représenté par le paramètre <parameter>result</parameter>.
  </para>
  <para>
   <function>maxdb_fetch_array</function> est une version 
   étendue de la fonction <function>maxdb_fetch_row</function>.
   En plus de stocker les données dans un tableau de résultats aux
   indices numériques , la fonction 
   <function>maxdb_fetch_array</function> peut également
   stocker les données dans des indices associatifs, en utilisant
   les noms de champs du résultat en tant que clés.
  </para>
  &database.field-case;
  &database.fetch-null;
  <para>
   Si deux colonnes ou plus du résultats ont les mêmes noms de
   champs, la dernière colonne aura la priorité et effacera les données 
   précédentes. Pour accéder aux autres colonnes du même nom, 
   la version indexée numériquement de la ligne doit être
   utilisée.
  </para>
  <para>
   Le second argument optionnel <parameter>resulttype</parameter> est une
   constante indiquant quel type de tableau doit être produit pour les données
   de la ligne courante. Les valeurs possibles pour ce paramètre sont les
   constantes <literal>MAXDB_ASSOC</literal>, <literal>MAXDB_ASSOC_UPPER</literal>,
   <literal>MAXDB_ASSOC_LOWER</literal>, <literal>MAXDB_NUM</literal>, ou
   <literal>MAXDB_BOTH</literal>. Par défaut, la fonction
   <function>maxdb_fetch_array</function> prendra la valeur
   <literal>MAXDB_BOTH</literal>, qui est une combinaison de
   <literal>MAXDB_NUM</literal> et de <literal>MAXDB_ASSOC</literal>,
   pour ce paramètre.
  </para>
  <para>
   En utilisant la constante <literal>MAXDB_ASSOC</literal>,
   cette fonction fonctionne de la même manière que la fonction
   <function>maxdb_fetch_assoc</function>, tandis que
   <literal>MAXDB_NUM</literal> fonctionne de la même manière
   que la fonction <function>maxdb_fetch_row</function>.
   L'option <literal>MAXDB_BOTH</literal> créera un seul
   tableau contenant les deux sortes d'attributs.
  </para>
  <para>
   En utilisant la constante MAXDB_ASSOC_UPPER, le comportement de cette fonction est identique
   à l'utilisation de MAXDB_ASSOC à la seule différence que l'index de la colonne du tableau
   est le nom du champs en majuscule.
  </para>
  <para>
   En utilisant la constante MAXDB_ASSOC_LOWER, le comportement de cette fonction est identique 
   à l'utilisation de MAXDB_ASSOC à la seule différence que l'index de la colonne du tableau
   est le nom du champs en minuscule.
  </para>
 </refsect1>

 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
   Retourne un tableau qui correspond à la ligne récupérée ou
   &null; s'il n'y a plus de lignes de disponibles dans le jeu de
   résultats.
  </para>
 </refsect1>

 <refsect1 role="examples">
  &reftitle.examples;
  <example>
   <title>Style orienté objet</title>
   <programlisting role="php">
<![CDATA[
<?php
$maxdb = new maxdb("localhost", "MONA", "RED", "DEMODB");

/* Vérification de la connexion */
if (maxdb_connect_errno()) {
    printf("Connect failed: %s\n", maxdb_connect_error());
    exit();
}

$query = "SELECT name, state FROM hotel.city ORDER by zip";
$result = $maxdb->query($query);

/* Tableau numérique */
$row = $result->fetch_array(MAXDB_NUM);
printf ("%s (%s)\n", $row[0], $row[1]);

/* Tableau associatif */
$row = $result->fetch_array(MAXDB_ASSOC);
printf ("%s (%s)\n", $row["NAME"], $row["STATE"]);

/* Tableau associatif et numérique */
$row = $result->fetch_array(MAXDB_BOTH);
printf ("%s (%s)\n", $row[0], $row["STATE"]);

/* Libération du jeu de résultats */
$result->close();

/* Fermeture de la connexion */
$maxdb->close();
?>
]]>
   </programlisting>
  </example>
  <example>
   <title>Style procédural</title>
   <programlisting role="php">
<![CDATA[
<?php
$link = maxdb_connect("localhost", "MONA", "RED", "DEMODB");

/* Vérification de la connexion */
if (maxdb_connect_errno()) {
    printf("Echec de la connexion : %s\n", maxdb_connect_error());
    exit();
}

$query = "SELECT name, state FROM hotel.city ORDER by zip";
$result = maxdb_query($link, $query);

/* Tableau numérique */
$row = maxdb_fetch_array($result, MAXDB_NUM);
printf ("%s (%s)\n", $row[0], $row[1]);

/* Tableau associatif */
$row = maxdb_fetch_array($result, MAXDB_ASSOC);
printf ("%s (%s)\n", $row["NAME"], $row["STATE"]);

/* Tableau associatif et numérique */
$row = maxdb_fetch_array($result, MAXDB_BOTH);
printf ("%s (%s)\n", $row[0], $row["STATE"]);

/* Libération du jeu de résultats */
maxdb_free_result($result);

/* Fermeture de la connexion */
maxdb_close($link);
?>
]]>
   </programlisting>
  </example>
  &example.outputs.similar;
  <screen>
<![CDATA[
New York (NY)
New York (NY)
Long Island (NY)
]]>
  </screen>
 </refsect1>

 <refsect1 role="seealso">
  &reftitle.seealso;
  <para>
   <simplelist>
    <member><function>maxdb_fetch_assoc</function></member>
    <member><function>maxdb_fetch_row</function></member>
    <member><function>maxdb_fetch_resource</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:"../../../../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
-->