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

    VersionDescription
    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');
    $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 boolfalse. 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
    To Top