current
current
(PHP 4, PHP 5, PHP 7)
当前 - 返回数组中的当前元素
描述
mixed current ( array $array )
每个数组都有一个指向其“当前”元素的内部指针,该元素被初始化为插入到数组中的第一个元素。
参数
array
数组。
返回值
当current()
函数仅返回内部指针当前指向的数组元素的值。它不会以任何方式移动指针。如果内部指针超出元素列表的末尾或数组为空,则current()
返回FALSE
。
警告
该函数可能返回布尔值FALSE
,但也可能返回一个非布尔值,其值为FALSE
。有关更多信息,请阅读布尔部分。使用===运算符来测试此函数的返回值。
更新日志
版 | 描述 |
---|---|
7.0.0 | 数组现在总是按值传递。在此版本之前,如果可能的话,它通过参考传递,否则通过价值。 |
例子
Example#1使用current()和friends的例子
<?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) { }
?>
笔记
注意
:数组的末尾和在空数组上调用current()
的结果与布尔FALSE
元素无法区分。要正确遍历可能包含FALSE
元素的数组,请参阅foreach()
函数。为了仍然使用current()
并正确地检查该值是否真的是数组的一个元素,应检查current()
元素的key()与严格区别NULL
。