(PHP 4, PHP 5, PHP 7, PHP 8)
next — Avance le pointeur interne d'un tableau
Description
next(array|object
&$array
): mixed
Liste de paramètres
-
array
-
Le tableau à traiter.
Valeurs de retour
Retourne la prochaine valeur du tableau suivant le pointeur interne,
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
Exemples
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';
?>
Notes
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ément false
, voyez la fonction
foreach
.
Pour continuer d'utiliser next() et détecter proprement
si la fin du tableau a été atteinte, la key() est null
.
Voir aussi
- current() - Retourne l'élément courant du tableau
- end() - Positionne le pointeur de tableau en fin de tableau
- prev() - Recule le pointeur courant de tableau
- reset() - Remet le pointeur interne de tableau au début
- each() - Retourne chaque paire clé/valeur d'un tableau