CKTIS / PHP
Iterator::valid — sprawdzanie bieżącej pozycji iteratora
Metoda `Iterator::valid()` sprawdza, czy iterator wskazuje element, który można odczytać. Nie ocenia wartości tego elementu i nie przesuwa iteratora.
Wersja: PHP 8.3
Składnia
public function valid(): boolIterator::valid() to metoda instancji bez argumentów, wywoływana jako $iterator->valid(). Zwraca true, gdy bieżąca pozycja wskazuje element, albo false, gdy na tej pozycji nie ma elementu. Nie przesuwa iteratora. Wartości null, false i 0 nadal mogą być poprawnymi elementami.
Gdy foreach korzysta z interfejsu Iterator, PHP najpierw wywołuje rewind(), a następnie valid(). Jeśli wynik to true, pętla pobiera wartość przez current() i, w razie potrzeby, klucz przez key(). Gdy pętla przechodzi dalej, next() przesuwa iterator, po czym valid() ponownie sprawdza pozycję. Wynik false kończy iterację bez odczytywania elementu z tej pozycji. Przy pustym iteratorze pierwszy test zwraca false.
Przy ręcznej iteracji sprawdzaj valid() przed odczytem przez current() lub key(). Jeśli pozycja w Twojej implementacji jest kluczem tablicy $items, użyj array_key_exists($position, $items), a nie isset($items[$position]): isset() zwraca false także dla istniejącego klucza o wartości null.
W PHP 8.3 interfejs Iterator jest wbudowany, a klasę ArrayIterator udostępnia rozszerzenie SPL, którego nie można wyłączyć.
Przykłady
<?php
$iterator = new ArrayIterator([null, false, 0]);
for ($iterator->rewind(); $iterator->valid(); $iterator->next()) {
var_dump($iterator->current());
}
var_dump($iterator->valid());
Wynik
NULL bool(false) int(0) bool(false)
Pierwsze trzy wiersze to wartości elementów zwrócone przez `current()`. Drugi wiersz, `bool(false)`, jest wartością elementu; dopiero ostatni `bool(false)` pochodzi z `valid()` i oznacza brak elementu na bieżącej pozycji.
Powiązane lekcje
- PHP · Lekcja 61 · Zaawansowany · Wersja: 2
- PHP · Lekcja 63 · Zaawansowany · Wersja: 2