將陣列中的內部指針向前移動一位

next

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

next 將陣列中的內部指針向前移動一位

說明

next(array|object &$array): mixed

next()current() 的行為類似,只有一點區別,在返回值之前將內部指針向前移動一位。這意味著它返回的是下一個陣列單元的值並將陣列指針向前移動了一位。

參數

array

受影響的 array

返回值

返回陣列內部指針指向的下一個單元的值,或當沒有更多單元時返回 false

警告

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

更新日誌

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

範例

示例 #1 next() 及相關函式的用法示例

<?php
$transport 
= array('foot''bike''car''plane');
$mode current($transport); // $mode = 'foot';
$mode next($transport);    // $mode = 'bike';
$mode next($transport);    // $mode = 'car';
$mode prev($transport);    // $mode = 'bike';
$mode end($transport);     // $mode = 'plane';
?>

註釋

注意: 很難區別是陣列尾部還是 boolean false 的單元。 要正確遍歷可能含有 false 單元的陣列,參見 each() 函式。 仍要使用 next() 並正確檢測陣列尾部, 需要檢查 key() 是否為 null

參見

  • current() - 返回陣列中的當前值
  • end() - 將陣列的內部指針指向最後一個單元
  • prev() - 將陣列的內部指針倒回一位
  • reset() - 將陣列的內部指針指向第一個單元
  • each() - 返回陣列中目前的鍵/值對並將陣列指針向前移動一步

發佈留言

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