Php/docs/function.current

• PHP Manual
• 数组 函数
• 返回数组中的当前单元

current

(PHP 4, PHP 5, PHP 7)

current — 返回数组中的当前单元

说明

current ( array &$array ) : mixed

每个数组中都有一个内部的指针指向它“当前的”单元，初始指向插入到数组中的第一个单元。

参数

array

这个数组。

返回值

current() 函数返回当前被内部指针指向的数组单元的值，并不移动指针。如果内部指针指向超出了单元列表的末端，current() 返回 false。

Warning 此函数可能返回布尔值 false，但也可能返回等同于 false 的非布尔值。请阅读 布尔类型章节以获取更多信息。应使用 === 运算符来测试此函数的返回值。

范例

Example #1 使用 current() 系列函数的例子

<?php$transport = array('foot', 'bike', 'car', 'plane');$mode = current($transport); // $mode = 'foot';$mode = next($transport);    // $mode = 'bike';$mode = current($transport); // $mode = 'bike';$mode = prev($transport);    // $mode = 'foot';$mode = end($transport);     // $mode = 'plane';$mode = current($transport); // $mode = 'plane';$arr = array();var_dump(current($arr)); // bool(false)$arr = array(array());var_dump(current($arr)); // array(0) { }?>

注释

Note:

如果数组包含 boolean false 的单元则本函数在碰到这个单元时也返回 false，使得不可能判断是否到了此数组列表的末端。 要正确遍历可能含有空单元的数组，用 each() 函数。

参见

• end() - 将数组的内部指针指向最后一个单元
• key() - 从关联数组中取得键名
• each() - 返回数组中当前的键／值对并将数组指针向前移动一步
• prev() - 将数组的内部指针倒回一位
• reset() - 将数组的内部指针指向第一个单元
• next() - 将数组中的内部指针向前移动一位