CKTIS / PHP
Generator::getReturn — dohvaćanje povratne vrijednosti generatora
Dohvati konačni rezultat nakon što generator uredno završi. Vrijednost iz `return` odvojena je od elemenata koje daje `yield`.
Verzija: PHP 8.3
Sintaksa
public function Generator::getReturn(): mixedGenerator::getReturn javna je metoda instance ugrađene klase \Generator, dostupna od PHP-a 7.0. Ne zahtijeva nijedno neobavezno proširenje. Pozovi je bez argumenata kao $generator->getReturn(). Poziv generatorske funkcije vraća objekt \Generator; povratni tip mixed u prikazanoj signaturi za PHP 8.3 opisuje konačnu vrijednost generatora, a ne tip tog objekta.
yield daje element iteraciji i privremeno zaustavlja izvršavanje. return završava generator, a njegova vrijednost ne postaje još jedan element petlje foreach. Kad petlja dođe do kraja, pročitaj rezultat iz istog objekta. Nije dovoljno primiti zadnji element: break može ostaviti generator zaustavljen na yield, a poziv metode u tom stanju baca \Exception.
Ako generator uredno završi bez vraćanja vrijednosti, metoda vraća null. Ako neuhvaćena iznimka prekine generator, nema rezultata za čitanje pa kasniji poziv metode getReturn() baca \Exception. Pri delegiranju drugom generatoru yield from prosljeđuje njegove elemente, a vrijednost izraza njegov je konačni rezultat. Vanjski generator može ga vratiti kao vlastiti pomoću return yield from $inner;.
Primjeri
<?php
function readings(): \Generator
{
$total = 0;
foreach ([4, 7] as $reading) {
$total += $reading;
yield $reading;
}
return $total;
}
$generator = readings();
foreach ($generator as $reading) {
echo 'item: ', $reading, "\n";
}
echo 'total: ', $generator->getReturn(), "\n";
Rezultat
item: 4 item: 7 total: 11
`foreach` ispisuje očitanja `4` i `7`. Tek nakon petlje `getReturn()` vraća zbroj `11`, koji nije element iteracije.
Povezane lekcije
- PHP · Lekcija 59 · Napredno · Verzija: 2