prev

(PHP 3, PHP 4, PHP 5)

prev -- 内部の配列ポインタを1つ前に戻す

説明

mixed prev ( array &array )

内部の配列ポインタが指している前の場所の配列値を返します。 もう要素がない場合は FALSE を返します。

警告

配列に空の要素がある場合、これらの要素についてこの関数が返す値は FALSE と評価されます (詳細な情報は、boolean への変換 および 型変換の表 を参照ください)。 空の要素がある配列を適切に順処理するには、 each() 関数を参照ください。

prev() は、内部の配列ポインタを 1 つ前に 戻すことを除けば next() と同じです。

例 1. prev() とその周辺を使った例

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

current(), end(), next(), reset() も参照ください。