doc-fr/reference/array/functions/list.xml

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- splitted from ./fr/functions/array.xml, last change in rev 1.30 -->
<!-- last change to 'list' in en/ tree in rev 1.2 -->
 <refentry id="function.list">
  <refnamediv>
   <refname>list</refname>
   <refpurpose>
    Transforme une liste de variables en tableau
   </refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
     <methodsynopsis>
      <type>void</type><methodname>list</methodname>
      <methodparam rep="repeat"><type>mixed</type><parameter>...</parameter></methodparam>
     </methodsynopsis>
   <para>
    Tout comme <function>array</function>, <function>list</function> n'est pas une
    v&eacute;ritable fonction, mais un &eacute;l&eacute;ment de langage, 
    qui permet d'assigner une s&eacute;rie de variables en une
    seule ligne.
    </para>
    <note>
     <para>
      <function>list</function> fonctionne uniquement avec des tableaux
      &agrave; indexation num&eacute;rique, et suppose que l'indexaction commence &agrave; 0.
     </para>
    </note>
    <para>
     <example>
      <title>Exemple avec <function>list</function></title>
      <programlisting role="php">
<![CDATA[
<?php

$info = array('caf&eacute;', 'noir', 'cafeine');

// Liste de toutes les variables
list($drink, $color, $power) = $info;
print "$drink est $color et la $power le rend particulier.\n";

// Liste de certaines variables
list($drink, , $power) = $info;
print "$drink contient de la $power.\n";

// Ou bien, n'utilisons que le troisi&egrave;me
list( , , $power) = $info;
print "J'ai besoin de $power!\n";

?>
]]>
      </programlisting>
     </example>
    </para>
    <para>
     <example>
      <title>Exemple avec <function>list</function> et MySQL</title>     
      <programlisting role="php">
<![CDATA[
<table>
 <tr>
  <th>Nom de l'employ&eacute;</th>
  <th>Salaire</th>
 </tr>

<?php

$resultat = mysql_query ("SELECT id, nom, salaire FROM employes",$conn);
while (list ($id, $nom, $salaire) = mysql_fetch_row ($resultat)) {
    print (" <tr>\n".
           "  <td><a href=\"info.php?id=$id\">$nom</a></td>\n".
           "  <td>$salaire</td>\n".
           " </tr>\n");
}

?>
</table>
]]>
      </programlisting>
     </example>
    </para>
    <warning>
    <para>
     <function>list</function> assigne les valeurs en commencant par la valeur
     la plus &agrave; droite. Si vous utiliser ces variables, ce ne sera pas un probl&egrave;me.
     Mais si vous utilisez des tableaux, vous serez surpris de voir que
     <function>list</function> les affecte de droite &agrave; gauche.
    </para>
    </warning>
    <para>
     <example>
      <title>Exemple avec <function>list</function> en tenan compte de l'ordre</title>
      <programlisting role="php">
<![CDATA[
<?php

$info = array('caf&eacute;', 'noir', 'cafeine');

list($a[0], $a[1], $a[2]) = $info;

var_dump($a);

?>
]]>
      </programlisting>
     </example>
     Cet exemple donne le r&eacute;sultat suivant (notez l'ordre d'affichage des
     &eacute;l&eacute;ments, en comparaison avec l'ordre dans lequel ils ont &eacute;t&eacute; &eacute;crits dans
     la syntaxe de <function>list</function>) :
     <screen>
array(3) {
  [2]=>
  string(8) "cafeine"
  [1]=>
  string(5) "noir"
  [0]=>
  string(6) "caf&eacute;"
}
     </screen>
    </para>
   <para>
    Voir aussi
    <function>extract</function>,
    <function>each</function> et
    <function>array</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
-->