next

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

next — 將數(shù)組中的內部指針向前移動一位

說明

next(array|object &$array): mixed

next() 和 current() 的行為類似，只有一點區(qū)別，在返回值之前將內部指針向前移動一位。這意味著它返回的是下一個數(shù)組單元的值并將數(shù)組指針向前移動了一位。

參數(shù)

array

受影響的 array 。

返回值

返回數(shù)組內部指針指向的下一個單元的值，或當沒有更多單元時返回 false。

警告

此函數(shù)可能返回布爾值 false，但也可能返回等同于 false 的非布爾值。請閱讀 布爾類型章節(jié)以獲取更多信息。應使用 === 運算符來測試此函數(shù)的返回值。

更新日志

版本 說明
8.1.0 棄用在 object 上調用此函數(shù)。 在 object 優(yōu)先使用 get_mangled_object_vars() 或者使用 ArrayIterator。

范例

示例 #1 next() 及相關函數(shù)的用法示例

<?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';
?>

注釋

注意: 很難區(qū)別是數(shù)組尾部還是 boolean false 的單元。 要正確遍歷可能含有 false 單元的數(shù)組，參見 each() 函數(shù)。 仍要使用 next() 并正確檢測數(shù)組尾部， 需要檢查 key() 是否為 null。

參見

  • current() - 返回數(shù)組中的當前值
  • end() - 將數(shù)組的內部指針指向最后一個單元
  • prev() - 將數(shù)組的內部指針倒回一位
  • reset() - 將數(shù)組的內部指針指向第一個單元
  • each() - 返回數(shù)組中當前的鍵／值對并將數(shù)組指針向前移動一步