prev

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

prev — 將數(shù)組的內(nèi)部指針倒回一位

說明

prev(array|object &$array): mixed

將數(shù)組的內(nèi)部指針倒回一位。

prev() 和 next() 的行為類似，只除了它將內(nèi)部指針倒回一位而不是前移一位。

參數(shù)

array

The input array.

返回值

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

警告

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

更新日志

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

范例

示例 #1 prev() 及相關(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';
?>

注釋

警告

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

注意: 很難區(qū)分是遇到 boolean false 單元還是遇到了數(shù)組的開頭。 需要用 key() 檢查 prev() 數(shù)組， 是否為 null 來作區(qū)分。

參見

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