CKTIS / PHP
Iterator::rewind — vrnitev iteratorja na začetek
Zanka `foreach` pokliče `Iterator::rewind()` pred prvim preverjanjem z `valid()`. Ali klic postavi iterator na začetek, je odvisno od implementacije.
Različica: PHP 8.3
Sintaksa
public function rewind(): voidIterator::rewind je javna metoda primerka brez parametrov z vračilnim tipom void. Klic $it->rewind() postavi iterator na prvi element, če ta obstaja. Metoda tega elementa ne vrne. Pri ročnem prehodu najprej preveri valid(), nato preberi vrednost z current() ali ključ s key(). Če je iterator prazen, valid() vrne false.
Ko foreach začne prehod po objektu, ki implementira Iterator, PHP pokliče rewind() pred prvim preverjanjem z valid(). Če se prehod po izvedbi telesa zanke nadaljuje, next() premakne iterator, valid() pa preveri novi položaj. Ob koncu zanke se rewind() ne pokliče. Pri ArrayIterator predhodni ročni premik ne spremeni položaja, na katerem se začne nova zanka.
Ne predpostavljaj, da lahko vsak iterator prehodiš znova. Generator::rewind() izvaja generator do prvega yield vključno. Če je generator že tam, klic ne stori ničesar; če je šel že dlje, sproži izjemo Exception. Če naj se zanka začne na trenutnem položaju, ovij iterator v NoRewindIterator: foreach še vedno pokliče rewind(), vendar ovoj klica ne posreduje notranjemu iteratorju.
Te metode ne zamenjuj z rewind($stream), ki spremeni položaj v datotečnem toku, ali z reset($array), ki notranji kazalec polja vrne na začetek.
Primeri
<?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";
}
Rezultat
beta alpha a=alpha b=beta
`next()` iterator najprej premakne na `beta`, izrecni klic `rewind()` pa ga vrne na `alpha`. Naslednji `next()` ga spet premakne na `beta`, vendar `foreach` začne z `a=alpha`, ker sam pokliče `rewind()`.
Povezane lekcije
- PHP · Lekcija 61 · Napredna · Različica: 2
- PHP · Lekcija 63 · Napredna · Različica: 2