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