***PHP 遍曆數組的方法foreach

標籤：

foreach 

http://php.net/manual/zh/control-structures.foreach.php

(PHP 4, PHP 5)

foreach 文法結構提供了遍曆數組的簡單方式。foreach 僅能夠應用於數組和對象，如果嘗試應用於其他資料類型的變數，或者未初始化的變數將發出錯誤資訊。有兩種文法：

foreach (array_expression as $value)    statementforeach (array_expression as $key => $value)    statement

第一種格式遍曆給定的 array_expression 數組。每次迴圈中，當前單元的值被賦給 $value 並且數組內部的指標向前移一步（因此下一次迴圈中將會得到下一個單元）。

第二種格式做同樣的事，只除了當前單元的鍵名也會在每次迴圈中被賦給變數 $key。

還能夠自訂遍曆對象。

 

Note:

當 foreach 開始執行時，數組內部的指標會自動指向第一個單元。這意味著不需要在 foreach 迴圈之前調用 reset()。

由於 foreach 依賴內部數組指標，在迴圈中修改其值將可能導致意外的行為。

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

<?php
$arr = array(1, 2, 3, 4);
foreach ($arr as &$value) {
    $value = $value * 2;
}
// $arr is now array(2, 4, 6, 8)
unset($value); // 最後取消掉引用
?>

$value 的引用僅在被遍曆的數組可以被引用時才可用（例如是個變數）。以下代碼則無法運行：

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

?>Warning

數組最後一個元素的 $value 引用在 foreach 迴圈之後仍會保留。建議使用 unset() 來將其銷毀。

 

Note:

foreach 不支援用“@”來抑制錯誤資訊的能力。

使用者可能注意到了以下的代碼功能完全相同：

<?php
$arr = array("one", "two", "three");
reset($arr);
while (list(, $value) = each($arr)) {
    echo "Value: $value<br>\n";
}

foreach ($arr as $value) {
    echo "Value: $value<br />\n";
}
?>

以下代碼功能也完全相同：

<?php
$arr = array("one", "two", "three");
reset($arr);
while (list($key, $value) = each($arr)) {
    echo "Key: $key; Value: $value<br />\n";
}

foreach ($arr as $key => $value) {
    echo "Key: $key; Value: $value<br />\n";
}
?>

示範用法的更多例子：

<?php
/* foreach example 1: value only */

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

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

/* foreach example 2: value (with its manual access notation printed for illustration) */

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

$i = 0; /* for illustrative purposes only */

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

/* foreach example 3: key and value */

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

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

/* foreach example 4: multi-dimensional arrays */
$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 example 5: dynamic arrays */

foreach (array(1, 2, 3, 4, 5) as $v) {
    echo "$v\n";
}
?>用 list() 給嵌套的數組解包

(PHP 5 >= 5.5.0)

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: 2A: 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";
}
?>

以上常式會輸出：

13

如果 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 7A: 1; B: 2; C: Notice: Undefined offset: 2 in example.php on line 7A: 3; B: 4; C: 

***PHP 遍曆數組的方法foreach