current
(PHP 4, PHP 5)
current — 返回数组中的当前单元
说明
mixed current
( array &$array
)
每个数组中都有一个内部的指针指向它“当前的”单元,初始指向插入到数组中的第一个单元。
参数
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() - 将数组中的内部指针向前移动一位