Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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

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

Viri