PHP each() 函數

PHP Array 函數

實例

返回當前元素的鍵名和鍵值，并將內部指針向前移動：

<?php
$people = array("Bill", "Steve", "Mark", "David");
print_r (each($people));
?>

運行實例

定義和用法

each() 函數返回當前元素的鍵名和鍵值，并將內部指針向前移動。

該元素的鍵名和鍵值會被返回帶有四個元素的數組中。兩個元素（1 和 Value）包含鍵值，兩個元素（0 和 Key）包含鍵名。

相關的方法：

  • current() - 返回數組中的當前元素的值
  • end() - 將內部指針指向數組中的最后一個元素，并輸出
  • next() - 將內部指針指向數組中的下一個元素，并輸出
  • prev() - 將內部指針指向數組中的上一個元素，并輸出
  • reset() - 將內部指針指向數組中的第一個元素，并輸出

語法

each(array)
參數 描述
array 必需。規定要使用的數組。

說明

each() 函數生成一個由數組當前內部指針所指向的元素的鍵名和鍵值組成的數組，并把內部指針向前移動。

返回的數組中包括的四個元素：鍵名為 0，1，key 和 value。單元 0 和 key 包含有數組單元的鍵名，1 和 value 包含有數據。

如果內部指針越過了數組范圍，本函數將返回 FALSE。

技術細節

返回值：

返回當前元素的鍵名和鍵值。該元素的鍵名和鍵值返回到帶有四個元素的數組中。

兩個元素（1 和 Value）包含鍵值，兩個元素（0 和 Key）包含鍵名。

如果沒有更多的數組元素，則函數返回 FALSE。
PHP 版本： 4+

更多實例

例子 1

與頁面頂部的實例相同，但是本例通過循環輸出整個數組：

<?php
$people = array("Bill", "Steve", "Mark", "David");
reset($people);
while (list($key, $val) = each($people))
  {
  echo "$key => $val<br>";
  }
?>

運行實例

例子 2

演示所有相關的方法：

<?php
$people = array("Bill", "Steve", "Mark", "David");
echo current($people) . "<br>"; // 當前元素是 Bill
echo next($people) . "<br>"; // Bill 的下一個元素是 Steve
echo current($people) . "<br>"; // 現在當前元素是 Steve
echo prev($people) . "<br>"; // Steve 的上一個元素是 Bill
echo end($people) . "<br>"; // 最后一個元素是 David
echo prev($people) . "<br>"; // David 之前的元素是 Mark
echo current($people) . "<br>"; // 目前的當前元素是 Mark
echo reset($people) . "<br>"; // 把內部指針移動到數組的首個元素，即 Bill
echo next($people) . "<br>"; // Bill 的下一個元素是 Steve
print_r (each($people)); // 返回當前元素的鍵名和鍵值（目前是 Steve），并向前移動內部指針
?>

運行實例

PHP Array 函數