Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / PHP

Iterator::rewind — povratak iteratora na početak

Petlja `foreach` poziva `Iterator::rewind()` prije prve provjere metodom `valid()`. Hoće li taj poziv postaviti iterator na početak ovisi o implementaciji.

Verzija: PHP 8.3

Sintaksa

public function rewind(): void

Iterator::rewind javna je metoda instance bez parametara s povratnim tipom void. Poziv $it->rewind() postavlja iterator na prvi element ako on postoji. Metoda ne vraća taj element. Pri ručnom prolasku najprije provjeri valid(), a zatim pročitaj vrijednost metodom current() ili ključ metodom key(). Ako je iterator prazan, valid() vraća false.

Kad foreach počne prolaziti kroz objekt koji implementira Iterator, PHP poziva rewind() prije prve provjere metodom valid(). Ako se prolazak nastavi nakon izvršavanja tijela petlje, next() pomiče iterator, a valid() provjerava novi položaj. Završetak petlje ne poziva rewind(). Kod ArrayIterator prethodni ručni pomak ne mijenja mjesto na kojem počinje nova petlja.

Nemoj pretpostaviti da se kroz svaki iterator može proći ponovo. Generator::rewind() izvršava generator do prvog yield, uključujući i taj izraz. Ako je generator već na tom mjestu, poziv ne radi ništa; ako ga je prešao, baca iznimku Exception. Za početak petlje na trenutačnom položaju omotaj iterator u NoRewindIterator: foreach i dalje poziva rewind(), ali omotač ne prosljeđuje poziv unutarnjem iteratoru.

Ova metoda nije isto što i rewind($stream), koji mijenja položaj u datotečnom toku, ni reset($array), koji vraća unutarnji pokazivač polja na početak.

Primjeri

<?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()` najprije pomiče iterator na `beta`, a izričit poziv `rewind()` vraća ga na `alpha`. Sljedeći `next()` ponovo ga pomiče na `beta`, ali `foreach` počinje s `a=alpha` jer sam poziva `rewind()`.

Povezane lekcije

  • PHP · Lekcija 61 · Napredno · Verzija: 2
  • PHP · Lekcija 63 · Napredno · Verzija: 2

Izvori