Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / PHP

Iterator::current — lire la valeur courante

Lisez la valeur à la position courante d’un itérateur sans le faire avancer. Vérifiez la position avec `valid()` pour ne pas confondre `null` ou `false` avec la fin de l’itération.

Version : PHP 8.3

Syntaxe

public function current(): mixed; // declaration inside an interface
$value = $iterator->current(); // call on an Iterator instance

Iterator::current est une méthode d’instance publique sans paramètre qui renvoie la valeur à la position courante de l’itérateur. Le type de retour mixed accepte toute valeur PHP, y compris null et false. L’appel $iterator->current() ne fait pas avancer l’itérateur : next() le fait avancer et key() lit la clé plutôt que la valeur.

Pour parcourir l’itérateur manuellement depuis le début, appelez rewind(), puis vérifiez la position avec valid() après ce premier appel et après chaque next(), avant de lire une valeur. Si valid() renvoie false, n’appelez pas current() : l’interface ne précise pas le résultat pour une position non valide. Ne détectez pas la fin en convertissant la valeur en bool ni en la comparant à null ou à false.

Dans une boucle foreach ordinaire sur un Iterator, PHP appelle rewind() au début et vérifie valid() avant de lire la valeur via current(). La forme foreach ($iterator as $key => $value) lit aussi la clé via key(). Si la boucle passe à l’itération suivante, PHP appelle next() et vérifie de nouveau la position.

Ne confondez pas cette méthode avec la fonction globale \current($array), qui lit l’élément désigné par le pointeur interne d’un tableau. Passer un objet à cette fonction est obsolète depuis PHP 8.1 et ne remplace pas un appel à la méthode de l’itérateur.

Exemples

<?php
$iterator = new \ArrayIterator(['a' => null, 'b' => false]);

for ($iterator->rewind(); $iterator->valid(); $iterator->next()) {
    $value = $iterator->current();
    printf("%s: %s\n", $iterator->key(), var_export($value, true));
}

Résultat

a: NULL
b: false

Cet exemple ne nécessite aucune extension facultative : `Iterator` est intégré à PHP 8.3 et la SPL ne peut pas être désactivée dans cette version. La classe SPL `\ArrayIterator` parcourt les deux entrées du tableau dans leur ordre d’insertion. `var_export($value, true)` produit le texte `NULL` ou `false`, ce qui rend les deux valeurs visibles. La boucle s’arrête lorsque `valid()` renvoie `false`, pas lorsque la valeur lue est `false`.

Leçons associées

  • PHP · Leçon 61 · Avancé · Version : 2
  • PHP · Leçon 63 · Avancé · Version : 2

Sources