Manuel PHP
Précédent |  | Suivant

# each

(PHP 3, PHP 4 )

each -- Retourne chaque paire clé/valeur d'un tableau

## Description

array each ( array array)

each() retourne la paire (clé/valeur) courante du tableau `array` et avance le pointeur de tableau. Cette paire est retournée dans un tableau de 4 éléments, avec les clés 0, 1, key, et value. Les éléments 0 et key contiennent le nom de la clé et, et 1 et value contiennent la valeur.

Si le pointeur interne de fichier est au-delà de la fin du tableau, each() retourne `FALSE`.

Exemple 1. Exemples avec each()
    <?php
      $foo = array("bob", "fred", "jussi", "jouni", "egon", "marliese");
      $bar = each($foo);
    ?>
`$bar` contient maintenant les paires suivantes: 0 => 0 1 => 'bob' key => 0 value => 'bob'
    <?php
      $foo = array ("Robert" => "Bob", "Seppo" => "Sepi");
      $bar = each ($foo);
    ?>
`$bar` contient maintenant les paires suivantes: 0 => 'Robert' 1 => 'Bob' key => 'Robert' value => 'Bob'

each() est utilisé conjointement avec list() pour étudier tous les éléments d'un tableau; par exemple, $HTTP_POST_VARS:

Exemple 2. Affichage de $HTTP_POST_VARS avec each()
    <?php
      echo "Valeurs transmises par la méthode POST:<br>";
      reset ($HTTP_POST_VARS);
      while (list ($key, $val) = each ($HTTP_POST_VARS)) {
        echo "$key => $val<br>";
      }
    ?>

Après chaque each(), le pointeur de tableau est déplacé au dernier élément, ou sur le dernier élément, lorsqu'on arrive à la fin.

Voir aussi key(), list(), current(), reset(), next() et prev().

Précédent | Sommaire | Suivant
current | Niveau supérieur | end