(PHP 4, PHP 5, PHP 7, PHP 8)
next — Avance le pointeur interne d'un tableau
next() se comporte comme current(), avec une différence. Il avance le pointeur interne du tableau d'un élément, avant de retourner la valeur de l'élément. Cela signifie qu'il retourne la prochaine valeur du tableau et avance le pointeur interne d'un élément.
arrayLe tableau à traiter.
Retourne la prochaine valeur du tableau suivant le pointeur interne,
ou false s'il n'y a plus d'élément.
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.
| 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. |
Exemple #1 Exemple avec next()
<?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';
?>
Note: Il n'est pas possible de distinguer la fin d'un tableau de l'élément bool
false. Pour traverser correctement un tableau qui peut contenir l'élémentfalse, voyez la fonctionforeach. Pour continuer d'utiliser next() et détecter proprement si la fin du tableau a été atteinte, la key() estnull.