4.7 Les structures de contrôle
4 Référence du langage
Manuel PHP
. if . else . elseif . Syntaxe alternative . while . do-while . for ->foreach . break . continue . switch . declare . return . require . include . require_once . include_once
|
4.7.8 foreach
PHP 4 introduit une commande
foreach
,
comme en Perl ou d'autres langages. C'est un moyen simple de passer
en revue un tableau. Il y a deux syntaxes possibles : la seconde est
une extension mineure mais pratique de la première.
Instruction foreach |
foreach(array_expression as $value) commandes foreach(array_expression as $key => $value) commandes
|
La première forme passe en revue le tableau
array_expression
. A chaque itération,
la valeur de l'élément courant est assignée à
$value
et le pointeur interne de tableau est
avancé d'un élément (ce qui fait qu'à
la prochaine itération, on accédera à
l'élément suivant).
La deuxième forme fait exactement la même chose, mais
c'est la clé de l'élément courant qui est
assigné à la variable
$key
.
Depuis PHP 5, il est possible d'
itérer également des objets .
Note |
Lorsque
foreach
démarre, le pointeur interne
de fichier est automatiquement ramené au premier
élément du tableau. Cela signifie que vous n'aurez
pas à faire appel à
reset
avant
foreach
.
|
Note |
Bien que le tableau soit référencé ,
foreach
travaille sur une copie
du tableau spécifié, et pas sur le tableau lui-même.
Par conséquent,
le pointeur de tableau n'est pas modifié, comme il le serait
avec le fonction
each
, et les modifications
faites dans le tableau ne seront pas prises en compte dans le
tableau original. Cependant, le pointeur interne du tableau original
est
avancé avec le traitement du tableau.
En supposant sur la boucle foreach effectue tout le traitement, le pointeur
interne du tableau sera à la fin du tableau.
Depuis PHP 5, vous pouvez facilement modifier les éléments d'un tableau
en faisant précéder la valeur
$value
avec &.
Ceci aura pour effet d'assigner par
référence au lieu de copier
la valeur.
<?php $arr = array(1, 2, 3, 4); foreach ($arr as &$value) { $value = $value * 2; } // $arr vaut maintenant array(2, 4, 6, 8) ?>
|
Ceci n'est possible que si le tableau itéré peut être réféencé (i.e. est une variable).
|
Note |
foreach
n'accepte pas l'opérateur de suppression
des erreurs @ .
|
Vous pouvez remarquer que les exemples suivants fonctionnent de
manière identique :
Instruction foreach et while |
<?php $arr = array("un", "deux", "trois"); reset($arr); while (list(, $value) = each($arr)) { echo "Valeur : $value<br />\n"; }
foreach ($arr as $value) { echo "Valeur : $value<br />\n"; } ?>
|
Les exemples suivants sont aussi fonctionnellement identiques :
Instruction foreach et while (2) |
<?php $arr = array("un", "deux", "trois"); reset($arr); while (list($key, $value) = each($arr)) { echo "Clé : $key; Valeur : $value<br />\n"; }
foreach ($arr as $key => $value) { echo "Clé : $key; Valeur : $value<br />\n"; } ?>
|
Voici quelques exemples de plus :
Instruction foreach et while (3) |
<?php /* exemple foreach 1 : la valeur seulement */
$a = array(1, 2, 3, 17);
foreach ($a as $v) { echo "Current value of \$a : $v.\n"; }
/* exemple foreach 2 : la valeur et sa clé d'index */
$a = array(1, 2, 3, 17);
$i = 0; /* uniquement pour l'illustration */
foreach ($a as $v) { echo "\$a[$i] => $v.\n"; $i++; }
/* exemple foreach 3 : la clé et la valeur */
$a = array ( "un" => 1, "deux" => 2, "trois" => 3, "dix-sept" => 17 );
foreach ($a as $k => $v) { echo "\$a[$k] => $v.\n"; }
/* exemple foreach 4 : tableaux multi-dimensionnels */
$a = array(); $a[0][0] = "a"; $a[0][1] = "b"; $a[1][0] = "y"; $a[1][1] = "z";
foreach ($a as $v1) { foreach ($v1 as $v2) { echo "$v2\n"; } }
/* exemple foreach 5 : tableaux dynamiques */
foreach (array(1, 2, 3, 4, 5) as $v) { echo "$v\n"; }
?>
|
|