CKTIS / PHP
Iterator::next — passer à l’élément suivant
`Iterator::next()` fait avancer un itérateur d’un cran sans renvoyer l’élément. Lors d’un parcours manuel, vérifiez `valid()` avant de lire la valeur avec `current()`.
Version : PHP 8.3
Syntaxe
public function Iterator::next(): void
Instance call: $iterator->next();Iterator::next est une méthode d’instance publique de l’interface Iterator. L’appel $iterator->next() ne prend aucun argument et modifie la position du même objet. En PHP 8.3, le type de retour void de cette méthode de l’interface est provisoire. La méthode se distingue de la fonction globale \next($array), qui avance le pointeur interne d’un tableau et renvoie la valeur à la nouvelle position, ou false s’il n’y a pas d’élément suivant.
En PHP 8.3, l’interface Iterator est intégrée, et la classe ArrayIterator utilisée dans l’exemple fait partie de la SPL, qui est toujours disponible. Il n’est pas nécessaire d’activer une extension facultative.
Pour parcourir l’itérateur manuellement, commencez par rewind(). Vérifiez la position avec valid() avant de lire la valeur avec current() ou la clé avec key(). Appelez next() après avoir traité l’élément. Une fois le dernier élément dépassé, valid() renvoie false : utilisez ce résultat pour détecter la fin, et non la valeur de l’élément ou le résultat de next().
Avec un objet Iterator, foreach appelle rewind() au début, puis appelle next() et vérifie valid() pour passer d’un tour au suivant. N’appelez pas next() une seconde fois dans le corps de la boucle, sauf si vous voulez sauter des éléments. Un break quitte la boucle sans nouvelle avancée automatique.
Exemples
<?php
$iterator = new \ArrayIterator(['red', 'blue']);
$iterator->rewind();
while ($iterator->valid()) {
echo $iterator->current(), "\n";
$iterator->next();
}
var_dump($iterator->valid());
Résultat
red blue bool(false)
L’exemple utilise `ArrayIterator` de la SPL. Il affiche d’abord `red`, puis `blue` après la première avancée. Après la deuxième, `valid()` renvoie `false`, affiché sous la forme `bool(false)`.
Leçons associées
- PHP · Leçon 61 · Avancé · Version : 2
- PHP · Leçon 63 · Avancé · Version : 2