each 函数

适用 PHP 版本

PHP 4，PHP 5，PHP 7（直到 PHP 7.2，PHP 7.2 后已废弃，PHP 8 不再支持）

函数说明

each() 函数用于返回数组的当前键名及其对应的值，并将数组指针向前移动一步。它主要用于遍历数组，但由于其设计较老，且从 PHP 7.2 开始废弃，推荐使用 foreach 代替。

函数语法

each(array &$array): array|false

参数

• array：传入的数组，传引用。

返回值

返回一个包含当前键名和对应值的数组，结构如下：

• 0：当前键对应的值
• 1：当前值
• 'key'：当前键名
• 'value'：当前值

如果数组内部指针已到达末尾，返回 false。

示例

$array = array("a" => 1, "b" => 2, "c" => 3);
<p>print_r(each($array));<br>
print_r(each($array));<br>

示例代码的说明

以上示例中，第一次调用 each() 返回数组第一个元素的键和值，即键名 "a" 和对应的值 1，并将指针移动到下一个元素。第二次调用则返回第二个元素 "b" => 2。继续调用直到数组末尾时，返回 false。