# prev

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

prev — Recule le pointeur courant de tableau

### Description

prev(array|object `&$array`): mixed

Recule le pointeur courant de tableau.

prev() se comporte exactement comme next(), mais elle fait reculer le pointeur plutôt que de l'avancer.

### Liste de paramètres

`array`

  Le tableau d'entrée.

### Valeurs de retour

Retourne la valeur précédente du tableau suivant le pointeur interne du tableau, ou `false` s'il n'y a plus d'élément.

Avertissement

Cette fonction peut retourner `false`, mais elle peut aussi retourner une valeur équivalent à `false`. Veuillez lire la section sur les booléens pour plus d'informations. Utilisez l'opérateur === pour tester la valeur de retour exacte de cette fonction.

### Historique

Version | Description
--- | ---
8.1.0 | Soit convertir l'objet en un tableau en utilisant get_mangled_object_vars() d'abord, ou utiliser les méthodes fournies par une classe qui implémente Iterator, telle que ArrayIterator.
7.4.0 | À partir de PHP 7.4.0, les instances de classes SPL sont traitées comme des objets vides sans propriétés au lieu d'appeler la méthode Iterator avec le même nom que cette fonction.

### Exemples

Exemple #1 Exemple avec 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';
?>`

### Notes

> Note: Il n'est pas possible de distinguer le début d'un tableau de l'élément bool `false`. Pour faire la distinction, vérifiez si la key() de l'élément prev() n'est pas `null`.

### Voir aussi

- current() - Retourne l'élément courant du tableau
- end() - Positionne le pointeur de tableau en fin de tableau
- next() - Avance le pointeur interne d'un tableau
- reset() - Remet le pointeur interne de tableau au début
- each() - Retourne chaque paire clé/valeur d'un tableau