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

CKTIS / PHP

Iterator::next — přechod na další prvek

`Iterator::next()` posune iterátor o jeden krok, ale prvek nevrací. Při ručním procházení ověřte pozici pomocí `valid()`, než přečtete hodnotu metodou `current()`.

Verze: PHP 8.3

Syntaxe

public function Iterator::next(): void

Instance call: $iterator->next();

Iterator::next je veřejná instanční metoda rozhraní Iterator. Volání $iterator->next() nepřijímá argumenty a mění pozici téhož objektu. V PHP 8.3 je void předběžný návratový typ této metody rozhraní. Nejde o totéž co globální funkce \next($array), která posune vnitřní ukazatel pole a vrátí hodnotu na nové pozici nebo false, pokud další prvek neexistuje.

V PHP 8.3 je rozhraní Iterator vestavěné a třída ArrayIterator z příkladu je součástí knihovny SPL, která je vždy dostupná. Není třeba zapínat žádné volitelné rozšíření.

Ruční procházení začněte voláním rewind(). Než přečtete hodnotu metodou current() nebo klíč metodou key(), zkontrolujte pozici pomocí valid(). Po zpracování prvku zavolejte next(). Po posunu za poslední prvek vrátí valid() hodnotu false. Konec rozpoznávejte podle tohoto výsledku, nikoli podle hodnoty prvku nebo výsledku volání next().

U objektu typu Iterator volá foreach na začátku rewind(). Při přechodu k dalšímu průchodu zavolá next() a ověří pozici pomocí valid(). Nevolejte next() znovu v těle cyklu, pokud nechcete přeskakovat prvky. Příkaz break ukončí cyklus bez dalšího automatického posunu.

Příklady

<?php
$iterator = new \ArrayIterator(['red', 'blue']);
$iterator->rewind();

while ($iterator->valid()) {
    echo $iterator->current(), "\n";
    $iterator->next();
}

var_dump($iterator->valid());

Výsledek

red
blue
bool(false)

Příklad používá `ArrayIterator` z knihovny SPL. Nejprve vypíše `red` a po prvním posunu `blue`. Po druhém posunu vrátí `valid()` hodnotu `false`, která se vypíše jako `bool(false)`.

Související lekce

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

Zdroje