Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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

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

Zdroje