Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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(): bool

Iterator::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

Źródła