Langage de programmation - PHP - Références de mots réservés (mots clefs)

FOREACH	Pour chaque
PHP 4+

foreach(variableliste as variable) instruction;

Nom	Description
variableliste	Ce paramètre permet d'indiquer le tableau à parcourir
variable	Ce paramètre permet d'indiquer la variable recevant le contenu d'une des cellules du tableau.

Ce mot réservé permet d'effectuer une boucle pour chaque élément d'un tableau.

Contrairement à d'autres langages, la fonction «foreach» garantie de parcourir dans le même sens le tableau que vous avez spécifié. Il commence du haut vers le bas du tableau. Il s'agit donc pas d'un parcours aléatoire mais bien linéaire.
Ce mot réservé utilise le pointeur interne fournit avec le tableau pour se souvenir de sa position, ainsi il va de soi qu'il ne lui ai pas possible de parcourir un mot clef «array».
Il est préférable d'utiliser cette instruction plutôt que «for(reset($tableau);current($tableau);next($tableau) { ... }» si vous utilisez de multiples fois les clefs et les données.
Lorsque cette instruction débute la boucle, il réinitialise automatiquement le pointeur du tableau au premier élément du tableau.
Puisque cette instruction utilise le pointeur du tableau lors de chaque passage de la boucle, il est préférable de ne pas altéré la valeur du pointeur de tableau.
Pour pouvoir modifier une cellule du tableau, vous devrez indiquer le symbole «&» avant le nom de la variable recevant la valeur du tableau dans l'instruction de boucle. Exemple :


				<?php
$tableau = array(6, 7, 8, 9);
foreach($tableau as &$valeur) {
    $valeur = $valeur * 10;
}
var_dump($tableau);
?>

on obtiendra le résultat suivant :

array(4) { [0]=> int(60) [1]=> int(70) [2]=> int(80) [3]=> &int(90) }

La référence contenu dans le paramètre de valeur est conservé après la fin de la boucle, vous devrez vous-même la supprimer à l'aide de la fonction «unset()».
L'instruction «foreach» n'accepte pas le symbole «@» afin de supprimer les erreurs.
A partir de la version PHP 5.5, il est possible d'utiliser la fonction «list()» afin d'obtenir le contenu d'un tableau contenu dans le tableau parcouru.

Cet exemple permet de montrer un simple boucle passant tous les éléments du tableau «$List» :


				<?php
$List = array('c1' => 'Mon premier','c2' => 'Mon deuxieme');

foreach($List as $clef => $valeur) {
 echo $clef.",".$valeur.";";

}
?>

on obtiendra le résultat suivant :

c1,Mon premier;c2,Mon deuxieme;

Dernière mise à jour : Vendredi, le 3 avril 2015

Section courante