CKTIS / PHP
Iterator::current — de huidige waarde lezen
Lees de waarde op de huidige positie van een iterator zonder die te verplaatsen. Controleer de positie met `valid()`, zodat je `null` of `false` niet verwart met het einde van de iteratie.
Versie: PHP 8.3
Syntax
public function current(): mixed; // declaration inside an interface
$value = $iterator->current(); // call on an Iterator instanceIterator::current is een openbare instantiemethode zonder parameters die de waarde op de huidige positie van de iterator teruggeeft. Het retourtype mixed staat elke PHP-waarde toe, inclusief null en false. Met $iterator->current() schuif je de iterator niet door: next() doet dat, terwijl key() de sleutel leest in plaats van de waarde.
Wil je de iterator handmatig vanaf het begin doorlopen, roep dan eerst rewind() aan. Controleer daarna en na elke next() de positie met valid() voordat je een waarde leest. Geeft valid() false terug, roep dan current() niet aan: de interface legt geen resultaat vast voor een ongeldige positie. Bepaal het einde niet door de waarde om te zetten naar bool of te vergelijken met null of false.
In een gewone foreach-lus over een Iterator roept PHP aan het begin rewind() aan en controleert het valid() voordat het de waarde via current() leest. Met foreach ($iterator as $key => $value) leest PHP ook de sleutel via key(). Gaat de lus door naar de volgende iteratie, dan roept PHP next() aan en controleert het de positie opnieuw.
Verwar de methode niet met de globale functie \current($array), die het element leest waarnaar de interne aanwijzer van een array verwijst. Een object doorgeven aan die functie is sinds PHP 8.1 verouderd en vervangt geen aanroep van de iteratormethode.
Voorbeelden
<?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));
}
Resultaat
a: NULL b: false
Voor dit voorbeeld is geen optionele extensie nodig: `Iterator` is ingebouwd in PHP 8.3 en SPL kan in die versie niet worden uitgeschakeld. De SPL-klasse `\ArrayIterator` doorloopt de twee array-elementen in invoegvolgorde. `var_export($value, true)` levert de tekst `NULL` of `false` op, zodat beide waarden zichtbaar zijn. De lus stopt wanneer `valid()` `false` teruggeeft, niet wanneer de gelezen waarde `false` is.
Gerelateerde lessen
- PHP · Les 61 · Gevorderd · Versie: 2
- PHP · Les 63 · Gevorderd · Versie: 2