foreach

(PHP 4, PHP 5, PHP 7, PHP 8)

foreach 語法結(jié)構(gòu)提供了遍歷數(shù)組的簡單方式。foreach 僅能夠應(yīng)用于數(shù)組和對象，如果嘗試應(yīng)用于其他數(shù)據(jù)類型的變量，或者未初始化的變量將發(fā)出錯(cuò)誤信息。有兩種語法：

foreach (iterable_expression as $value)
    statement
foreach (iterable_expression as $key => $value)
    statement

第一種格式遍歷給定的 iterable_expression 迭代器。每次循環(huán)中，當(dāng)前單元的值被賦給 $value。

第二種格式做同樣的事，只除了當(dāng)前單元的鍵名也會(huì)在每次循環(huán)中被賦給變量 $key。

注意 foreach 不會(huì)修改類似 current() 和 key() 函數(shù)所使用的數(shù)組內(nèi)部指針。

還能夠自定義遍歷對象。

可以很容易地通過在 $value 之前加上 & 來修改數(shù)組的元素。此方法將以引用賦值而不是拷貝一個(gè)值。


<?php
$arr = array(1, 2, 3, 4);
foreach ($arr as &$value) {
    $value = $value * 2;
}
// 現(xiàn)在 $arr 是 array(2, 4, 6, 8)
unset($value); // 最后取消掉引用
?>

警告

數(shù)組最后一個(gè)元素的 $value 引用在 foreach 循環(huán)之后仍會(huì)保留。建議使用 unset() 來將其銷毀。否則你會(huì)遇到下面的情況：


<?php
$arr = array(1, 2, 3, 4);
foreach ($arr as &$value) {
    $value = $value * 2;
}
// 現(xiàn)在 $arr 是 array(2, 4, 6, 8)

// 未使用 unset($value) 時(shí)，$value 仍然引用到最后一項(xiàng) $arr[3]

foreach ($arr as $key => $value) {
    // $arr[3] 會(huì)被 $arr 的每一項(xiàng)值更新掉…
    echo "{$key} => {$value} ";
    print_r($arr);
}
// 直到最終倒數(shù)第二個(gè)值被復(fù)制到最后一個(gè)值

// output:
// 0 => 2 Array ( [0] => 2, [1] => 4, [2] => 6, [3] => 2 )
// 1 => 4 Array ( [0] => 2, [1] => 4, [2] => 6, [3] => 4 )
// 2 => 6 Array ( [0] => 2, [1] => 4, [2] => 6, [3] => 6 )
// 3 => 6 Array ( [0] => 2, [1] => 4, [2] => 6, [3] => 6 )
?>

可以通過引用來遍歷數(shù)組常量的值：


<?php
foreach (array(1, 2, 3, 4) as &$value) {
    $value = $value * 2;
}
?>

注意:
foreach 不支持用 “@” 來抑制錯(cuò)誤信息的能力。

示范用法的更多例子：


<?php
/* foreach 示例 1：僅 value */

$a = array(1, 2, 3, 17);

foreach ($a as $v) {
   echo "Current value of \$a: $v.\n";
}

/* foreach 示例 2：value （打印手動(dòng)訪問的符號以供說明） */

$a = array(1, 2, 3, 17);

$i = 0; /* 僅供說明 */

foreach ($a as $v) {
    echo "\$a[$i] => $v.\n";
    $i++;
}

/* foreach 示例 3：key 和 value */

$a = array(
    "one" => 1,
    "two" => 2,
    "three" => 3,
    "seventeen" => 17
);

foreach ($a as $k => $v) {
    echo "\$a[$k] => $v.\n";
}

/* foreach 示例 4：多維數(shù)組 */
$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";
    }
}

/* foreach 示例 5：動(dòng)態(tài)數(shù)組 */

foreach (array(1, 2, 3, 4, 5) as $v) {
    echo "$v\n";
}
?>

用 list() 給嵌套的數(shù)組解包

(PHP 5 >= 5.5.0, PHP 7, PHP 8)

可以遍歷一個(gè)數(shù)組的數(shù)組并且把嵌套的數(shù)組解包到循環(huán)變量中，只需將 list() 作為值提供。

例如：


<?php
$array = [
    [1, 2],
    [3, 4],
];

foreach ($array as list($a, $b)) {
    // $a 包含嵌套數(shù)組的第一個(gè)元素，
    // $b 包含嵌套數(shù)組的第二個(gè)元素。
    echo "A: $a; B: $b\n";
}
?>

以上例程會(huì)輸出：

A: 1; B: 2
A: 3; B: 4

list() 中的單元可以少于嵌套數(shù)組的，此時(shí)多出來的數(shù)組單元將被忽略：


<?php
$array = [
    [1, 2],
    [3, 4],
];

foreach ($array as list($a)) {
    // 注意這里沒有 $b。
    echo "$a\n";
}
?>

以上例程會(huì)輸出：

1
3

如果 list() 中列出的單元多于嵌套數(shù)組則會(huì)發(fā)出一條消息級別的錯(cuò)誤信息：


<?php
$array = [
    [1, 2],
    [3, 4],
];

foreach ($array as list($a, $b, $c)) {
    echo "A: $a; B: $b; C: $c\n";
}
?>

以上例程會(huì)輸出：

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: