Recule le pointeur courant de tableau

(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	Appeler cette fonction sur les objets est obsolète. Utilisez soit get_mangled_object_vars() sur l'objet d'abord, ou utilisez ArrayIterator.

Exemples

Exemple #1 Exemple avec prev()


<?php
$transport = array('foot', 'bike', 'car', 'plane');
$mode = current($transport); // $mode = 'foot';
$mode = next($transport);    // $mode = 'bike';
$mode = next($transport);    // $mode = 'car';
$mode = prev($transport);    // $mode = 'bike';
$mode = end($transport);     // $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