Documentación offline PHP master

prev

master Ver versión oficial en línea Licencia CC-BY-3.0Descargado el 2026-08-02

En esta página

prev

Retrocede el puntero actual del array

Descripción#

prev(array $array): mixed
```php

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.

> [!WARNING]
> 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](#language.types.boolean) para más información. Utilice el [operador ===](#language.operators.comparison) 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](#book.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 con `prev`

```php

Notas#

[!NOTE] 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.

Véase también#

current, end, next, reset, each