PHP each() Fonction

❮ Référence PHP Array

Exemple

Retourne la clé et la valeur de l'élément actuel, et déplace le pointeur interne vers l'avant :

<?php
$people = array("Peter", "Joe", "Glenn", "Cleveland");
print_r (each($people));
?>

Définition et Utilisation

La fonction each() retourne la clé et la valeur de l'élément actuel, tout en déplaçant le pointeur interne vers l'avant.

Remarque : Cette fonction a été dépréciée dans PHP 7.2 et supprimée dans PHP 8.0.

La clé et la valeur de cet élément sont retournées dans un tableau contenant quatre éléments : deux éléments (1 et Valeur) pour la valeur de l'élément, et deux éléments (0 et Clé) pour la clé de l'élément.

Méthodes associées :

  • current() - retourne la valeur de l'élément actuel dans un tableau
  • end() - déplace le pointeur interne vers le dernier élément du tableau et l'affiche
  • next() - déplace le pointeur interne vers le prochain élément du tableau et l'affiche
  • prev() - déplace le pointeur interne vers l'élément précédent du tableau et l'affiche
  • reset() - déplace le pointeur interne vers le premier élément du tableau

Syntaxe

each( array )

Valeurs des Paramètres

Paramètre Description
array Requis. Spécifie le tableau à utiliser


Détails Techniques

Valeur de Retour : Retourne la clé et la valeur de l'élément actuel. Cette clé et cette valeur sont retournées dans un tableau avec quatre éléments : deux éléments (1 et Valeur) pour la valeur de l'élément, et deux éléments (0 et Clé) pour la clé de l'élément. Cette fonction retourne FALSE s'il n'y a plus d'éléments dans le tableau.
Version PHP : 4+

Plus d'Exemples

Exemple

Même exemple que celui en haut de la page, mais avec une boucle pour afficher tout le tableau :

<?php
$people = array("Peter", "Joe", "Glenn", "Cleveland");

reset($people);

while (list($key, $val) = each($people))
{
echo "$key => $val<br>";
}
?>

Exemple

Une démonstration de toutes les méthodes associées :

<?php
$people = array("Peter", "Joe", "Glenn", "Cleveland");

echo current($people) . "<br>"; // L'élément actuel est Peter
echo next($people) . "<br>"; // Le prochain élément de Peter est Joe
echo current($people) . "<br>"; // Maintenant, l'élément actuel est Joe
echo prev($people) . "<br>"; // L'élément précédent de Joe est Peter
echo end($people) . "<br>"; // Le dernier élément est Cleveland
echo prev($people) . "<br>"; // L'élément précédent de Cleveland est Glenn
echo current($people) . "<br>"; // Maintenant, l'élément actuel est Glenn
echo reset($people) . "<br>"; // Déplace le pointeur interne vers le premier élément du tableau, qui est Peter
echo next($people) . "<br>"; // Le prochain élément de Peter est Joe

print_r (each($people)); // Retourne la clé et la valeur de l'élément actuel (maintenant Joe), et déplace le pointeur interne vers l'avant
?>

❮ Référence PHP Array