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

CKTIS / PHP

Iterator::current — čtení aktuální hodnoty

Přečtěte hodnotu na aktuální pozici iterátoru, aniž byste ho posunuli. Pozici ověřte pomocí `valid()`, abyste si hodnoty `null` a `false` nespletli s koncem iterace.

Verze: PHP 8.3

Syntaxe

public function current(): mixed; // declaration inside an interface
$value = $iterator->current(); // call on an Iterator instance

Iterator::current je veřejná instanční metoda bez parametrů, která vrací hodnotu na aktuální pozici iterátoru. Návratový typ mixed připouští libovolnou hodnotu PHP včetně null a false. Volání $iterator->current() iterátor neposouvá: o posun se stará next(), zatímco key() čte klíč namísto hodnoty.

Při ručním průchodu od začátku zavolejte rewind() a po něm i po každém next() ověřte pozici metodou valid(), než hodnotu přečtete. Pokud valid() vrátí false, nevolejte current(): rozhraní neurčuje výsledek pro neplatnou pozici. Konec nezjišťujte převodem hodnoty na bool ani porovnáním s null či false.

V běžném cyklu foreach nad objektem Iterator zavolá PHP na začátku rewind() a zkontroluje valid(), než přečte hodnotu pomocí current(). Zápis foreach ($iterator as $key => $value) načte pomocí key() i klíč. Pokud cyklus pokračuje další iterací, PHP zavolá next() a pozici ověří znovu.

Nezaměňujte tuto metodu s globální funkcí \current($array), která čte prvek označený interním ukazatelem pole. Předávání objektu této funkci je od PHP 8.1 zastaralé a nenahrazuje volání metody iterátoru.

Příklady

<?php
$iterator = new \ArrayIterator(['a' => null, 'b' => false]);

for ($iterator->rewind(); $iterator->valid(); $iterator->next()) {
    $value = $iterator->current();
    printf("%s: %s\n", $iterator->key(), var_export($value, true));
}

Výsledek

a: NULL
b: false

Příklad nevyžaduje žádné volitelné rozšíření: `Iterator` je součástí PHP 8.3 a knihovnu SPL v této verzi nelze vypnout. Třída `\ArrayIterator` z knihovny SPL projde dvě položky pole v pořadí vložení. `var_export($value, true)` vytvoří text `NULL` nebo `false`, takže jsou obě hodnoty vidět. Cyklus skončí, když `valid()` vrátí `false`, nikoli když je přečtená hodnota `false`.

Související lekce

  • PHP · Lekce 61 · Pokročilá · Verze: 2
  • PHP · Lekce 63 · Pokročilá · Verze: 2

Zdroje