Descripción

prev(array|object &$array): mixed

Retrocede el puntero actual del array.

prev() se comporta exactamente como next(), pero retrocede el puntero en lugar de avanzarlo.

Parámetros

array: El array de entrada.

Valores devueltos

Devuelve el valor anterior del array según el puntero interno del array, o false si no hay más elementos.

Advertencia

Esta función puede retornar false, pero también puede retornar un valor equivalente a false. Por favor, lea la sección sobre los booleanos para más información. Utilice el operador === para probar el valor de retorno exacto de esta función.

Historial de cambios

Versión	Descripción
8.1.0	O bien convertir el object en un array utilizando get_mangled_object_vars() primero, o utilizar los métodos proporcionados por una clase que implemente Iterator, tal como ArrayIterator.
7.4.0	A partir de PHP 7.4.0, las instancias de clases SPL son tratadas como objetos vacíos sin propiedades en lugar de llamar al método Iterator con el mismo nombre que esta función.

Ejemplos

Ejemplo #1 Ejemplo con prev()

<?php
$transport = array('foot', 'bike', 'car', 'plane');
echo $mode = current($transport), PHP_EOL; // $mode = 'foot';
echo $mode = next($transport), PHP_EOL;    // $mode = 'bike';
echo $mode = next($transport), PHP_EOL;    // $mode = 'car';
echo $mode = prev($transport), PHP_EOL;    // $mode = 'bike';
echo $mode = end($transport), PHP_EOL;     // $mode = 'plane';
?>

Notas

Nota: No es posible distinguir el inicio de un array del elemento bool false. Para hacer la distinción, verifique si la key() del elemento prev() no es null.

Ver también

current() - Devuelve el elemento actual del array
end() - Posiciona el puntero del array al final del array
next() - Avance el puntero interno de un array
reset() - Reinicia el puntero interno del array al principio
each() - Devuelve cada par clave/valor de un array