CKTIS / PHP
Iterator::rewind — návrat iterátora na začiatok
Cyklus `foreach` volá `Iterator::rewind()` pred prvou kontrolou cez `valid()`. To, či volanie nastaví iterátor na začiatok, závisí od implementácie.
Verzia: PHP 8.3
Syntax
public function rewind(): voidIterator::rewind je verejná inštančná metóda bez parametrov s návratovým typom void. Volanie $it->rewind() nastaví iterátor na prvý prvok, ak existuje. Metóda tento prvok nevracia. Pri ručnom prechádzaní najprv skontrolujte valid() a až potom čítajte hodnotu cez current() alebo kľúč cez key(). Pri prázdnom iterátore valid() vráti false.
Keď foreach začne prechádzať objekt implementujúci Iterator, PHP zavolá rewind() pred prvou kontrolou cez valid(). Ak prechádzanie po vykonaní tela cyklu pokračuje, next() posunie iterátor a valid() overí novú pozíciu. Ukončenie cyklu nespôsobí volanie rewind(). Pri ArrayIterator predchádzajúci ručný posun nemení miesto, kde začne nový cyklus.
Nepredpokladajte, že každý iterátor možno prejsť znova. Generator::rewind() spustí generátor až po prvý yield vrátane. Ak už je generátor na tomto mieste, volanie nič neurobí; ak pokročil ďalej, vyvolá výnimku Exception. Ak má cyklus začať na aktuálnej pozícii, obaľte iterátor pomocou NoRewindIterator: foreach stále volá rewind(), no obal volanie neodovzdá vnútornému iterátoru.
Táto metóda nie je rewind($stream), ktorá mení pozíciu v súborovom prúde, ani reset($array), ktorá vracia vnútorný ukazovateľ poľa na začiatok.
Príklady
<?php
$items = new ArrayIterator(['a' => 'alpha', 'b' => 'beta']);
$items->next();
echo $items->current(), "\n";
$items->rewind();
echo $items->current(), "\n";
$items->next();
foreach ($items as $key => $value) {
echo $key, '=', $value, "\n";
}
Výsledok
beta alpha a=alpha b=beta
`next()` najprv posunie iterátor na `beta` a explicitné volanie `rewind()` ho vráti na `alpha`. Ďalšie `next()` ho znova posunie na `beta`, ale `foreach` začne výpisom `a=alpha`, pretože sám volá `rewind()`.
Súvisiace lekcie
- PHP · Lekcia 61 · Pokročilá · Verzia: 2
- PHP · Lekcia 63 · Pokročilá · Verzia: 2