next

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

next — 將數(shù)組中的內(nèi)部指針向前移動(dòng)一位

說明

next(array|object &$array): mixed

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

參數(shù)

array

受影響的 array 。

返回值

返回?cái)?shù)組內(nèi)部指針指向的下一個(gè)單元的值，或當(dāng)沒有更多單元時(shí)返回 false。

警告

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

更新日志

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

范例

示例 #1 next() 及相關(guān)函數(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() 并正確檢測(cè)數(shù)組尾部， 需要檢查 key() 是否為 null。

參見

  • current() - 返回?cái)?shù)組中的當(dāng)前值
  • end() - 將數(shù)組的內(nèi)部指針指向最后一個(gè)單元
  • prev() - 將數(shù)組的內(nèi)部指針倒回一位
  • reset() - 將數(shù)組的內(nèi)部指針指向第一個(gè)單元
  • each() - 返回?cái)?shù)組中當(dāng)前的鍵／值對(duì)并將數(shù)組指針向前移動(dòng)一步