PHP 4 引入了 foreach 結構,和 Perl 以及其他語言很像。這只是一種遍歷數組簡便方法。foreach 僅能用於數組,當試圖將其用於其它數據類型或者一個未初始化的變量時會產生錯誤。有兩種語法,第二種比較次要但卻是第一種的有用的擴展。
foreach (array_expression as $value)
statement
foreach (array_expression as $key => $value)
statement
第一種格式遍歷給定的 array_expression 數組。每次循環中,當前單元的值被賦給 $value 並且數組內部的指針向前移一步(因此下一次循環中將會得到下一個單元)。
第二種格式做同樣的事,只除了當前單元的鍵名也會在每次循環中被賦給變量 $key。
自PHP 5 起,還可能遍歷對象。
注意:當 foreach 開始執行時,數組內部的指針會自動指向第一個單元。這意味着不需要在 foreach 循環之前調用 reset()。
注意:除非數組是被引用,foreach 所操作的是指定數組的一個拷貝,而不是該數組本身。foreach對數組指針有些副作用。除非對其重置,在 foreach 循環中或循環后都不要依賴數組指針的值。
自 PHP 5 起,可以很容易地通過在 $value 之前加上 & 來修改數組的元素。此方法將以引用賦值而不是拷貝一個值。
<?php
$arr = array(1, 2, 3, 4);
foreach ($arr as &$value) {
$value = $value * 2;
}
// $arr is now array(2, 4, 6, 8)
?>
此方法僅在被遍歷的數組可以被引用時才可用(例如是個變量)。
<?php
foreach (array(1, 2, 3, 4) as &$value) {
$value = $value * 2;
}
?>
第二種格式做同樣的事,只除了當前單元的鍵名也會在每次循環中被賦給變量 $key。
自PHP 5 起,還可能遍歷對象。
注意:當 foreach 開始執行時,數組內部的指針會自動指向第一個單元。這意味着不需要在 foreach 循環之前調用 reset()。
注意:除非數組是被引用,foreach 所操作的是指定數組的一個拷貝,而不是該數組本身。foreach對數組指針有些副作用。除非對其重置,在 foreach 循環中或循環后都不要依賴數組指針的值。
自 PHP 5 起,可以很容易地通過在 $value 之前加上 & 來修改數組的元素。此方法將以引用賦值而不是拷貝一個值。
<?php
$arr = array(1, 2, 3, 4);
foreach ($arr as &$value) {
$value = $value * 2;
}
// $arr is now array(2, 4, 6, 8)
?>
此方法僅在被遍歷的數組可以被引用時才可用(例如是個變量)。
<?php
foreach (array(1, 2, 3, 4) as &$value) {
$value = $value * 2;
}
?>
用 list() 給嵌套的數組解包 ¶
(PHP 5 >= 5.5.0, PHP 7)
PHP 5.5 增添了遍歷一個數組的數組的功能並且把嵌套的數組解包到循環變量中,只需將 list() 作為值提供。
例如:
<?php
$array = [
[1, 2],
[3, 4],
];
foreach ($array as list($a, $b)) {
// $a contains the first element of the nested array,
// and $b contains the second element.
echo "A: $a; B: $b\n";
}
?>
以上例程會輸出:
A: 1; B: 2 A: 3; B: 4
list() 中的單元可以少於嵌套數組的,此時多出來的數組單元將被忽略:
<?php
$array = [
[1, 2],
[3, 4],
];
foreach ($array as list($a)) {
// Note that there is no $b here.
echo "$a\n";
}
?>
以上例程會輸出:
1 3
如果 list() 中列出的單元多於嵌套數組則會發出一條消息級別的錯誤信息:
<?php
$array = [
[1, 2],
[3, 4],
];
foreach ($array as list($a, $b, $c)) {
echo "A: $a; B: $b; C: $c\n";
}
?>
以上例程會輸出:
Notice: Undefined offset: 2 in example.php on line 7 A: 1; B: 2; C: Notice: Undefined offset: 2 in example.php on line 7 A: 3; B: 4; C:
