Retrocede el puntero actual del array

# prev

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

prev — Retrocede el puntero actual del array

### Descripción

function 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

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open