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

CKTIS / PHP

IteratorAggregate::getIterator — delegiranje iteracije v `foreach`

Implementirajte `getIterator()`, da določite, katere ključe in vrednosti `foreach` prebere iz objekta. Metoda zagotovi objekt `Traversable`, ne tabele.

Različica: PHP 8.3

Sintaksa

public function getIterator(): \Traversable

V PHP 8.3 je IteratorAggregate::getIterator javna metoda primerka brez parametrov. Ko foreach začne prehod po objektu, ki implementira IteratorAggregate, pokliče to metodo ter pridobi ključe in vrednosti iz vrnjenega objekta. V nasprotju z razredom, ki implementira Iterator, zbirki ni treba sami slediti trenutnemu položaju.

V PHP 8.3 je povratni tip \Traversable vmesnika začasen. Implementacija lahko deklarira : \Traversable kot v primeru ali združljiv ožji povratni tip (kovariantnost), na primer : \Generator. Metoda lahko na primer vrne \ArrayIterator ali z yield posreduje elemente prek objekta \Generator. Tabela ni objekt Traversable, čeprav jo foreach lahko prehodi in jo tip iterable sprejme. Če metoda z deklariranim tipom \Traversable vrne tabelo, nastane TypeError.

Izbirne razširitve niso potrebne: IteratorAggregate, Traversable in generatorji so vgrajeni v PHP, ArrayIterator pa je del obvezne razširitve SPL.

Če naj zbirka podpira ponovljene ali ugnezdene prehode, ob vsakem klicu ustvarite nov iterator. Vračanje istega generatorja lahko onemogoči naslednji prehod: ko generator napreduje prek prvega yield, ga ni mogoče vrniti na začetek.

Primeri

<?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 prehoda uporabljata isto paleto. Vsaka zanka `foreach` pa dobi nov generator in zato izpiše ista dva para ključ–vrednost v istem vrstnem redu.

Povezane lekcije

  • PHP · Lekcija 62 · Napredna · Različica: 2

Viri