返回陣列中的當前值

current

(PHP 4, PHP 5, PHP 7, PHP 8)

current返回陣列中的當前值

說明

current(array|object $array): mixed

每個陣列中都有一個內部的指針指向它「目前的」單元,初始化時會指向該陣列中的第一個值。

參數

array

要操作的陣列。

返回值

current() 函式返回目前被內部指針指向的陣列單元的值,並不移動指針。如果內部指針指向超出了單元列表的末端,current() 將返回 false

警告

此函式可能返回布爾值 false,但也可能返回等同於 false 的非布爾值。請閱讀 布爾型別章節以獲取更多資訊。應使用 === 運算子來測試此函式的返回值。

更新日誌

版本 說明
8.1.0 棄用在 object 上呼叫此函式。 在 object 優先使用 get_mangled_object_vars() 或者使用 ArrayIterator

範例

示例 #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) { }
?>

註釋

注意: 在一個空陣列上使用 current() 函式,和在一個內部指針指向單元末端以外的陣列上使用此函式,結果是相同的,同樣都會返回 bool false。如果希望正確遍歷一個包含 false 的陣列,請參閱 foreach 控制結構。 如果仍然希望使用 current() 來判斷陣列單元真實的值,應該同時使用 key()current() 來檢查目前元素是否為 null

參見

  • end() - 將陣列的內部指針指向最後一個單元
  • key() - 從關聯陣列中取得鍵名
  • each() - 返回陣列中目前的鍵/值對並將陣列指針向前移動一步
  • prev() - 將陣列的內部指針倒回一位
  • reset() - 將陣列的內部指針指向第一個單元
  • next() - 將陣列中的內部指針向前移動一位
  • foreach

發佈留言

發佈留言必須填寫的電子郵件地址不會公開。 必填欄位標示為 *