Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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(): \Traversable

U 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

Izvori