(PHP 4, PHP 5)
current — 返回數組中的當前單元
說明
mixed current ( array&$array
)
每個數組中都有一個內部的指針指向它“當前的”單元,初始指向插入到數組中的第一個單元。
參數
array
這個數組。
返回值
current() 函數返回當前被內部指針指向的數組單元的值,并不移動指針。如果內部指針指向超出了單元列表的末端,current()
返回 FALSE
。
此函數可能返回布爾值
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() - 將數組中的內部指針向前移動一位