CKTIS / PHP
Generator::getReturn — branje vrnjene vrednosti generatorja
Preberite končni rezultat generatorja po njegovem običajnem zaključku. Vrednost iz `return` je ločena od elementov, ki jih posreduje `yield`.
Različica: PHP 8.3
Sintaksa
public function Generator::getReturn(): mixedGenerator::getReturn je javna metoda primerka vgrajenega razreda \Generator, ki je na voljo od PHP 7.0. Ne zahteva nobene izbirne razširitve. Pokličite jo brez argumentov z $generator->getReturn(). Klic generatorske funkcije vrne objekt \Generator; povratni tip mixed v prikazanem podpisu za PHP 8.3 opisuje končno vrednost generatorja, ne tipa tega objekta.
yield posreduje element iteraciji in začasno ustavi izvajanje. return konča generator, njegova vrednost pa ni dodaten element zanke foreach. Ko se zanka izvede do konca, preberite rezultat iz istega objekta. Prejeti zadnji element ni dovolj: break lahko pusti generator ustavljen pri yield, klic metode v tem stanju pa sproži \Exception.
Če se generator običajno konča, ne da bi vrnil vrednost, metoda vrne null. Če generator konča neprestrezena izjema, rezultata ni in poznejši klic getReturn() sproži \Exception. Pri delegiranju drugemu generatorju yield from posreduje njegove elemente, vrednost izraza pa je njegov končni rezultat. Zunanji generator ga lahko vrne kot svoj rezultat z return yield from $inner;.
Primeri
<?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` izpiše meritvi `4` in `7`. Šele po zanki `getReturn()` vrne vsoto `11`, ki ni element iteracije.
Povezane lekcije
- PHP · Lekcija 59 · Napredna · Različica: 2