Manuel PHP
PrécédentSuivant

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 tableau est au-delà de la fin du tableau, each() retourne FALSE.

Exemple 1. Exemples avec each()

<?php
  $foo = array("ghislain", "damien", "didou", "guillaume", "jim", "christophe");
  $bar = each($foo);
  print_r($bar);
?>

$bar contient maintenant les paires suivantes : 
Array
(
    [1] => ghislain
    [value] => ghislain
    [0] => 0
    [key] => 0
)
<?php
  $foo = array( "Mehdi" => "Didou","Damien" => "Dams");
  $bar = each($foo);
  print_r($bar);
?>

$bar contient maintenant les paires suivantes : 
Array
(
    [1] => Didou
    [value] => Didou
    [0] => Mehdi
    [key] => Mehdi
)

each() est typiquement utilisé en conjonction avec list() pour passer en revue un tableau. Par exemple, avec $_POST :

Exemple 2. Passer en revue $_POST avec each()

echo "Valeurs transmises via la m&eacute;thode POST :<br />\n";
reset ($_POST);
while (list ($key, $val) = each ($_POST)) {
    echo "$key => $val<br />\n";
}

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

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

PrécédentSommaireSuivant
currentNiveau supérieurend