prev

(PHP 3, PHP 4 , PHP 5)

prev -- Retrocede o ponteiro interno de um array

Descrição

mixed prev ( array array )

Retorna o valor do array que está na posição anterior a posição apontada pelo ponteiro interno, ou FALSE se houver mais elementos.

Atenção

Se o array contiver elementos vazios então essa função retornará FALSE para esses elementos. Para percorrer corretamente arrays que podem conter elementos vazios veja a função each().

prev() funciona da mesma forma que next(), com a única diferença sendo de que a primeira retrocede o ponteiro interno em uma posição ao invés de avançá-lo.

Exemplo 1. Exemplo de uso prev() e funções relacionadas

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

Veja também current(), end(), next() e reset().