CKTIS / PHP
Iterator::valid — Aktuelle Iteratorposition prüfen
`Iterator::valid()` prüft, ob an der aktuellen Position des Iterators ein Element vorhanden ist. Die Methode prüft nicht den Wert des Elements und bewegt den Iterator nicht weiter.
Version: PHP 8.3
Syntax
public function valid(): boolIterator::valid() ist eine Instanzmethode ohne Argumente und wird als $iterator->valid() aufgerufen. Sie liefert true, wenn an der aktuellen Position ein Element vorhanden ist, andernfalls false. Sie bewegt den Iterator nicht weiter. Auch null, false und 0 können gültige Elemente sein.
Wenn foreach die Schnittstelle Iterator verwendet, ruft PHP zu Beginn zuerst rewind() und dann valid() auf. Bei true liest die Schleife den Wert mit current() und bei Bedarf den Schlüssel mit key(). Wenn die Schleife fortgesetzt wird, rückt next() den Iterator weiter und valid() prüft die neue Position. Bei false endet die Iteration, ohne an dieser Position ein Element zu lesen. Bei einem leeren Iterator liefert bereits die erste Prüfung false.
Prüfe bei manueller Iteration mit valid(), bevor du current() oder key() aufrufst. Wenn deine Implementierung die Position als Schlüssel im Array $items verwendet, nutze array_key_exists($position, $items) statt isset($items[$position]): isset() liefert auch für einen vorhandenen Schlüssel mit dem Wert null den Wert false.
In PHP 8.3 ist die Schnittstelle Iterator eingebaut. Die Klasse ArrayIterator gehört zur SPL-Erweiterung, die sich nicht deaktivieren lässt.
Beispiele
<?php
$iterator = new ArrayIterator([null, false, 0]);
for ($iterator->rewind(); $iterator->valid(); $iterator->next()) {
var_dump($iterator->current());
}
var_dump($iterator->valid());
Ergebnis
NULL bool(false) int(0) bool(false)
Die ersten drei Zeilen zeigen die von `current()` gelieferten Elementwerte. Das `bool(false)` in der zweiten Zeile ist ein Elementwert; erst das letzte `bool(false)` stammt von `valid()` und bedeutet, dass an der aktuellen Position kein Element vorhanden ist.
Zugehörige Lektionen
- PHP · Lektion 61 · Fortgeschritten · Version: 2
- PHP · Lektion 63 · Fortgeschritten · Version: 2