archived-doc-fr/reference/array/functions/each.xml

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.22 $ -->
<!-- EN-Revision: 1.17 Maintainer: dams Status: ready -->
 <refentry id="function.each">
  <refnamediv>
   <refname>each</refname>
   <refpurpose>
    Retourne chaque paire clé/valeur d'un tableau
   </refpurpose>
  </refnamediv>
  <refsect1>
   &reftitle.description;
   <methodsynopsis>
    <type>array</type><methodname>each</methodname>
    <methodparam><type>array</type><parameter role="reference">array</parameter></methodparam>
   </methodsynopsis>
   <para>
    <function>each</function> retourne la paire clé/valeur courante
    du tableau <parameter>array</parameter> et avance le pointeur de tableau.
    Cette paire est retournée dans un tableau de 4 éléments,
    avec les clés &zero;, &one;,
    <literal>key</literal>, et <literal>value</literal>. Les
    éléments &zero; et <literal>key</literal>
    contiennent le nom de la clé et &one; et
    <literal>value</literal> contiennent la valeur.
   </para>
   <para>
    Si le pointeur interne de tableau est au-delà de la fin du tableau,
    <function>each</function> retourne &false;.
   </para>
   <para>
    <example>
     <title>Exemples avec <function>each</function></title>
     <programlisting role="php">
 <![CDATA[
<?php
$foo = array("ghislain", "damien", "didou", "guillaume", "jim", "christophe");
$bar = each($foo);
print_r($bar);
?>
]]>
     </programlisting>
     &example.outputs;
     <screen>
<![CDATA[
Array
(
    [1] => ghislain
    [value] => ghislain
    [0] => 0
    [key] => 0
)
]]>
     </screen>
     <programlisting role="php">
 <![CDATA[
<?php
$foo = array("Mehdi" => "Didou", "Damien" => "Dams");
$bar = each($foo);
print_r($bar);
?>
]]>
     </programlisting>
     &example.outputs;
     <screen>
<![CDATA[
Array
(
    [1] => Didou
    [value] => Didou
    [0] => Mehdi
    [key] => Mehdi
)
]]>
     </screen>
    </example>
   </para>
   <para>
    <function>each</function> est typiquement utilisée en conjonction
    avec <function>list</function> pour passer en revue un tableau.
    Par exemple :
    <example>
     <title>Passer en revue un tableau avec <function>each</function></title>
     <programlisting role="php">
<![CDATA[
<?php
$fruit = array('a' => 'pomme', 'b' => 'banane', 'c' => 'canneberge');

reset($fruit);
while (list($key, $val) = each($fruit)) {
    echo "$key => $val\n";
}
?>
]]>
     </programlisting>
     &example.outputs;
     <screen>
<![CDATA[
a => pomme
b => banane
c => canneberge
]]>
     </screen>
    </example>
   </para>
   <para>
    Après chaque appel à <function>each</function>, le pointeur de tableau est
    déplacé au prochain élément, ou sur le dernier élément, lorsqu'on arrive à
    la fin. Vous devez utiliser <function>reset</function> si vous voulez traverser
    le tableau à nouveau avec <function>each</function>.
   </para>
   <caution>
    <para>
     Assigner un tableau à une autre variable remet le pointeur du tableau original
     à zéro. A cause de ce comportement, nous aurions pu provoquer une boucle infinie
     dans notre exemple si nous avions assigné <varname>$fruit</varname> à une autre
     variable dans notre boucle.
    </para>
   </caution>
   <para>
    Voir aussi
    <function>key</function>,
    <function>list</function>,
    <function>current</function>,
    <function>reset</function>,
    <function>next</function>,
    <function>prev</function> et
    <link linkend="control-structures.foreach">foreach</link>.
   </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
-->