prev

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

prevRetrocede el puntero actual del array

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 objeto 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