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

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- splitted from ./fr/functions/array.xml, last change in rev 1.30 -->
<!-- last change to 'each' in en/ tree in rev 1.2 -->
 <refentry id="function.each">
  <refnamediv>
   <refname>each</refname>
   <refpurpose>
    Retourne chaque paire cl&eacute;/valeur d'un tableau
   </refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>array</type><methodname>each</methodname>
     <methodparam><type>array</type><parameter>array</parameter></methodparam>
    </methodsynopsis>
   <para>
    <function>each</function> retourne la paire (cl&eacute;/valeur) courante
    du tableau <parameter>array</parameter> et avance le pointeur de tableau.
    Cette paire est retourn&eacute;e dans un tableau de 4 &eacute;l&eacute;ments,
    avec les cl&eacute;s  <emphasis>0</emphasis>, <emphasis>1</emphasis>,
    <emphasis>key</emphasis>, et <emphasis>value</emphasis>. Les
    &eacute;l&eacute;ments <emphasis>0</emphasis> et <emphasis>key</emphasis>
    contiennent le nom de la cl&eacute; et, et <emphasis>1</emphasis> et
    <emphasis>value</emphasis> contiennent la valeur.
   </para>
   <para>
    Si le pointeur interne de fichier est au-del&agrave; de la fin du tableau,
    <function>each</function> retourne &false;.
   </para>
   <para>
    <example>
     <title>Exemples avec <function>each</function></title>
     <programlisting role="php">
&lt;?php
  $foo = array("bob", "fred", "jussi", "jouni", "egon", "marliese");
  $bar = each($foo);
?&gt;
     </programlisting>
     <para>
      <literal>$bar</literal> contient maintenant les paires suivantes:
      <itemizedlist spacing="compact">
       <listitem><simpara>0 =&gt; 0</simpara></listitem>
       <listitem><simpara>1 =&gt; 'bob'</simpara></listitem>
       <listitem><simpara>key =&gt; 0</simpara></listitem>
       <listitem><simpara>value =&gt; 'bob'</simpara></listitem>
      </itemizedlist>
      <programlisting role="php">
&lt;?php
  $foo = array ("Robert" =&gt; "Bob", "Seppo" =&gt; "Sepi");
  $bar = each ($foo);
?&gt;
      </programlisting>
     </para>
     <para>
      <literal>$bar</literal> contient maintenant les paires suivantes:
      <itemizedlist spacing="compact">
       <listitem><simpara>0 =&gt; 'Robert'</simpara></listitem>
       <listitem><simpara>1 =&gt; 'Bob'</simpara></listitem>
       <listitem><simpara>key =&gt; 'Robert'</simpara></listitem>
       <listitem><simpara>value =&gt; 'Bob'</simpara></listitem>
      </itemizedlist>
     </para>
    </example>
   </para>
   <para>
    <function>each</function> est utilis&eacute; conjointement avec
    <function>list</function> pour &eacute;tudier tous les &eacute;l&eacute;ments
    d'un tableau; par exemple, $HTTP_POST_VARS:
    <example>
     <title>
      Affichage de $HTTP_POST_VARS avec <function>each</function>
     </title>
     <programlisting role="php">
&lt;?php
  echo "Valeurs transmises par la m&eacute;thode POST:&lt;br&gt;";
  reset ($HTTP_POST_VARS);
  while (list ($key, $val) = each ($HTTP_POST_VARS)) {
    echo "$key =&gt; $val&lt;br&gt;";
  }
?&gt;
     </programlisting>
    </example>
   </para>
   <para>
    Apr&egrave;s chaque <function>each</function>, le pointeur de tableau est
    d&eacute;plac&eacute; au dernier &eacute;l&eacute;ment, ou sur le dernier
    &eacute;l&eacute;ment, lorsqu'on arrive &agrave; la fin.
   </para>
   <para>
    Voir aussi
    <function>key</function>,
    <function>list</function>,
    <function>current</function>,
    <function>reset</function>,
    <function>next</function> et
    <function>prev</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
-->