CKTIS / PHP
Iterator::valid — Vérifier la position courante de l’itérateur
`Iterator::valid()` indique si un élément est présent à la position courante de l’itérateur. La méthode ne teste pas la valeur de cet élément et ne fait pas avancer l’itérateur.
Version : PHP 8.3
Syntaxe
public function valid(): boolIterator::valid() est une méthode d’instance sans argument qui s’appelle sous la forme $iterator->valid(). Elle renvoie true si un élément est présent à la position courante et false sinon. Elle ne fait pas avancer l’itérateur. Les valeurs null, false et 0 peuvent toutes être des éléments valides.
Lorsque foreach utilise l’interface Iterator, PHP commence par appeler rewind(), puis valid(). Si le résultat est true, la boucle récupère la valeur avec current() et, si nécessaire, la clé avec key(). Lorsque la boucle se poursuit, next() fait avancer l’itérateur et valid() vérifie la nouvelle position. Un résultat false met fin au parcours sans lire d’élément à cette position. Si l’itérateur est vide, le premier test renvoie false.
Lors d’un parcours manuel, appelle valid() avant de lire la valeur ou la clé avec current() ou key(). Si ton implémentation utilise la position comme clé dans le tableau $items, utilise array_key_exists($position, $items) plutôt que isset($items[$position]) : isset() renvoie aussi false pour une clé existante dont la valeur est null.
Dans PHP 8.3, l’interface Iterator est intégrée à PHP et la classe ArrayIterator est fournie par l’extension SPL, qui ne peut pas être désactivée.
Exemples
<?php
$iterator = new ArrayIterator([null, false, 0]);
for ($iterator->rewind(); $iterator->valid(); $iterator->next()) {
var_dump($iterator->current());
}
var_dump($iterator->valid());
Résultat
NULL bool(false) int(0) bool(false)
Les trois premières lignes affichent les valeurs des éléments renvoyées par `current()`. Le `bool(false)` de la deuxième ligne est la valeur d’un élément ; seul le dernier `bool(false)` vient de `valid()` et signale qu’il n’y a pas d’élément à la position courante.
Leçons associées
- PHP · Leçon 61 · Avancé · Version : 2
- PHP · Leçon 63 · Avancé · Version : 2