CKTIS / PHP
IteratorAggregate::getIterator — delegiranje iteracije u `foreach`
Implementirajte `getIterator()` da odredite koje će ključeve i vrijednosti `foreach` čitati iz objekta. Metoda daje objekt `Traversable`, a ne polje.
Verzija: PHP 8.3
Sintaksa
public function getIterator(): \TraversableU PHP-u 8.3 IteratorAggregate::getIterator javna je metoda instance bez parametara. Kad foreach počne prolaziti kroz objekt koji implementira IteratorAggregate, poziva tu metodu te uzima ključeve i vrijednosti iz vraćenog objekta. Za razliku od klase koja implementira Iterator, zbirka ne mora sama pratiti trenutačni položaj.
Povratni tip \Traversable tog sučelja u PHP-u 8.3 privremen je. Implementacija može deklarirati : \Traversable kao u primjeru ili kompatibilan uži povratni tip (kovarijantnost), primjerice : \Generator. Metoda može, primjerice, vratiti \ArrayIterator ili pomoću yield davati elemente preko objekta \Generator. Polje nije objekt Traversable, iako ga foreach može proći i tip iterable ga prihvaća. Vraćanje polja uz deklarirani tip \Traversable uzrokuje TypeError.
Nije potrebno nijedno neobavezno proširenje: IteratorAggregate, Traversable i generatori ugrađeni su u PHP, a ArrayIterator dio je obaveznog proširenja SPL.
Ako zbirka treba podržavati ponovljene ili ugniježđene prolaze, pri svakom pozivu stvorite novi iterator. Vraćanje istog generatora može onemogućiti sljedeći prolaz: generator se ne može vratiti na početak nakon što prođe prvi yield.
Primjeri
<?php
final class ColorPalette implements \IteratorAggregate
{
public function getIterator(): \Traversable
{
yield 'primary' => 'blue';
yield 'accent' => 'orange';
}
}
$palette = new ColorPalette();
for ($pass = 1; $pass <= 2; $pass++) {
echo "Pass {$pass}:\n";
foreach ($palette as $role => $color) {
echo "{$role} = {$color}\n";
}
}
Rezultat
Pass 1: primary = blue accent = orange Pass 2: primary = blue accent = orange
Oba prolaza upotrebljavaju istu paletu. No svaka petlja `foreach` dobiva novi generator pa ispisuje ista dva para ključ–vrijednost istim redoslijedom.
Povezane lekcije
- PHP · Lekcija 62 · Napredno · Verzija: 2