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

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- splitted from ./fr/functions/array.xml, last change in rev 1.30 -->
<!-- last change to 'array-walk' in en/ tree in rev 1.2 -->
 <refentry id="function.array-walk">
  <refnamediv>
   <refname>array_walk</refname>
   <refpurpose>
    Ex&eacute;cute une fonction sur chacun des membres d'un tableau.
   </refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
     <methodsynopsis>
      <type>int</type><methodname>array_walk</methodname>
      <methodparam><type>array</type><parameter>array</parameter></methodparam>
      <methodparam><type>callback</type><parameter>function</parameter></methodparam>
      <methodparam choice="opt"><type>mixed</type><parameter>userdata</parameter></methodparam>
     </methodsynopsis>
   <simpara>
    <function>array_walk</function> ex&eacute;cute la fonction <parameter>func</parameter>
    avec chaque &eacute;l&eacute;ment du tableau <parameter>arr</parameter>. Les
    &eacute;l&eacute;ments sont pass&eacute;s en tant que premier argument de la
    fonction <parameter>func</parameter>. <parameter>func</parameter> doit &ecirc;tre
    une fonction d&eacute;finie par l'utilisateur, et non pas une fonction native
    PHP. Vous ne pouvez pas utiliser <function>array_walk</function> directement
    avec <function>str2lower</function>, il faut absolument passer par une fonction utilisateur.
   </simpara>
   <simpara>
    Si <parameter>func</parameter> a besoin de plus d'un argument, une alerte
    sera g&eacute;n&eacute;r&eacute;e pour chaque appel de <parameter>func</parameter>.
    Ces alertes sont supprim&eacute;es en ajoutant le suffixe '&#64;' avant l'appel de
    <function>array_walk</function> ou simplement en utilisant
    <function>error_reporting</function>.
   </simpara>
   <note>
    <para>
     Si <parameter>func</parameter> doit travailler avec les v&eacute;ritables
     valeurs du tableau, sp&eacute;cifiez que le premier param&egrave;tre de
     <parameter>func</parameter> doit &ecirc;tre pass&eacute; par
     r&eacute;f&eacute;rence. Alors, les &eacute;l&eacute;ments seront directement
     modifi&eacute;s dans le tableau.
    </para>
   </note>
   <note>
    <para>
     Passer les cl&eacute;s et <parameter>userdata</parameter> &agrave;
     <parameter>func</parameter> a &eacute;t&eacute; ajout&eacute; en PHP 4.0.
    </para>
    <para>
     En PHP 4, <function>reset</function> doit &ecirc;tre appel&eacute; si
     n&eacute;cessaire, car <function>array_walk</function> ne r&eacute;initialise pas
     automatiquement le tableau.
    </para>
   </note>
   <para>
    <example>
     <title>Exemple avec <function>array_walk</function></title>
     <programlisting role="php">
<![CDATA[
<?php
  $fruits = array ("d"=>"citron", "a"=>"orange", "b"=>"banane", "c"=>"pomme");

  function test_alter (&$item1, $key, $prefix) {
    $item1 = "$prefix: $item1";
  }

  function test_print ($item2, $key) {
    echo "$key. $item2<br>\n";
  }

  array_walk ($fruits, 'test_print');
  reset ($fruits);

  array_walk ($fruits, 'test_alter', 'fruit');
  reset ($fruits);

  array_walk ($fruits, 'test_print');
?>
]]>
     </programlisting>
    <para>
     L'affichage de ce script sera : 
       <screen role="php">
<![CDATA[
d. citron<br>
a. orange<br>
b. banane<br>
c. pomme<br>
d. fruit: citron<br>
a. fruit: orange<br>
b. fruit: banane<br>
c. fruit: pomme<br>
]]>
       </screen>
      </para>
     </example>
    </para>
    <simpara>
    Voir aussi
    <function>each</function> et
    <function>list</function>.
   </simpara>
  </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
-->