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 devolver el valor booleano false, pero también puede devolver un valor no booleano que se evalúa como false. Por favor lea la sección sobre Booleanos para más información. Use el operador === para comprobar el valor devuelto por esta función.

Historial de cambios

Versión Descripción
8.1.0 Calling this function on objets is deprecated. Either convert the objet to an tableau using get_mangled_object_vars() first, or use the methods provided by a class that implements Iterator, such as ArrayIterator, instead.
7.4.0 Instances of SPL classes are now treated like empty objects that have no properties instead of calling the Iterator method with the same name as this function.

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