CKTIS / PHP
Iterator::valid — Kontrola aktuální pozice iterátoru
`Iterator::valid()` zjišťuje, zda je na aktuální pozici iterátoru prvek. Nevyhodnocuje hodnotu prvku a neposouvá iterátor na další pozici.
Verze: PHP 8.3
Syntaxe
public function valid(): boolIterator::valid() je instanční metoda bez argumentů, která se volá jako $iterator->valid(). Vrací true, pokud je na aktuální pozici prvek, jinak vrací false. Iterátor neposouvá. I null, false a 0 mohou být hodnoty platných prvků.
Když cyklus foreach používá rozhraní Iterator, PHP nejprve zavolá rewind() a potom valid(). Pokud je výsledkem true, cyklus získá hodnotu pomocí current() a podle potřeby také klíč pomocí key(). Když cyklus pokračuje, next() posune iterátor a valid() zkontroluje novou pozici. Výsledek false ukončí průchod bez čtení prvku na této pozici. U prázdného iterátoru vrátí false už první kontrola.
Při ručním průchodu nejdřív zkontroluj valid() a až potom čti hodnotu nebo klíč pomocí current() či key(). Pokud tvoje implementace používá pozici jako klíč v poli $items, použij array_key_exists($position, $items) místo isset($items[$position]): isset() vrací false i pro existující klíč s hodnotou null.
V PHP 8.3 je Iterator vestavěné rozhraní a třídu ArrayIterator poskytuje rozšíření SPL, které nelze vypnout.
Příklady
<?php
$iterator = new ArrayIterator([null, false, 0]);
for ($iterator->rewind(); $iterator->valid(); $iterator->next()) {
var_dump($iterator->current());
}
var_dump($iterator->valid());
Výsledek
NULL bool(false) int(0) bool(false)
První tři řádky zobrazují hodnoty prvků vrácené metodou `current()`. `bool(false)` na druhém řádku je hodnota prvku; až poslední `bool(false)` pochází z `valid()` a znamená, že na aktuální pozici není žádný prvek.
Související lekce
- PHP · Lekce 61 · Pokročilá · Verze: 2
- PHP · Lekce 63 · Pokročilá · Verze: 2