程式
each(PHP 3, PHP 4, PHP 5)
each -- 返回數組中當前的鍵/值對並將數組指針向前移動一步
說明
array each ( array &array )返回 array 數組中當前指針位置的鍵/值對並向前移動數組指針。鍵值對被返回為四個單元的數組,鍵名為 0,1,key 和 value。單元 0 和 key 包含有數組單元的鍵名,1 和 value 包含有數據。
如果內部指針越過了數組的末端,則 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() 結合使用來遍歷數組,例如: 例子 2. 用 each() 遍歷數組
$fruit = array('a' => 'apple', 'b' => 'banana', 'c' => 'cranberry');
reset($fruit);
while (list($key, $val) = each($fruit)) {
echo "$key => $val\n";
}
?>
上例將輸出:
a => apple
b => banana
c => cranberry
在執行 each() 之後,數組指針將停留在數組中的下一個單元或者當碰到數組結尾時停留在最後一個