each

(PHP 3, PHP 4 )

each --  返回数组中当前的键/值对并将数组指针向前移动一步

说明

array each ( array array)

返回 array 数组中当前指针位置的键/值对并向前移动数组指针。键值对被返回为四个单元的数组,键名为 01keyvalue。单元 0key 包含有数组单元的键名,1value 包含有数据。

如果内部指针越过了数组的末端,则 each() 返回 FALSE

例子 1. each() 例子

$foo = array ("bob", "fred", "jussi", "jouni", "egon", "marliese");
$bar = each ($foo);
print_r($bar);

$bar 现在包含有如下的键/值对:
Array
{
    [1] => bob
    [value] => bob
    [0] => 0
    [key] => 0
}
$foo = array ("Robert" => "Bob", "Seppo" => "Sepi");
$bar = each ($foo);
print_r($bar);

$bar 现在包含有如下的键/值对:
Array
{
    [1] => Bob
    [value] => Bob
    [0] => Robert
    [key] => Robert
}

each() 经常和 list() 结合使用来遍历数组,例如 $_POST

例子 2. 用 each() 遍历 $_POST

echo "Values submitted via POST method:<br />\n";
reset ($_POST);
while (list ($key, $val) = each ($_POST)) {
    echo "$key => $val<br />\n";
}

在执行 each() 之后,数组指针将停留在数组中的下一个单元或者当碰到数组结尾时停留在最后一个单元。如果要再用 each 遍历数组,必须使用 reset()

参见 key()list()current()reset()next()prev()foreach