CKTIS / PHP
Generator::getReturn — získanie návratovej hodnoty generátora
Získajte konečný výsledok po riadnom dokončení generátora. Hodnota z `return` je oddelená od položiek poskytovaných pomocou `yield`.
Verzia: PHP 8.3
Syntax
public function Generator::getReturn(): mixedGenerator::getReturn je verejná inštančná metóda vstavanej triedy \Generator, dostupná od PHP 7.0. Nevyžaduje žiadne voliteľné rozšírenie. Volajte ju bez argumentov ako $generator->getReturn(). Volanie generátorovej funkcie vráti objekt \Generator; návratový typ mixed v uvedenej signatúre pre PHP 8.3 opisuje konečnú hodnotu generátora, nie typ tohto objektu.
yield poskytne položku iterácii a pozastaví vykonávanie generátora. return generátor ukončí a jeho hodnota sa nestane ďalšou položkou v foreach. Po úplnom prejdení cyklu načítajte výsledok z toho istého objektu. Získanie poslednej položky nestačí: break môže nechať generátor pozastavený na yield a volanie metódy v tomto stave vyvolá \Exception.
Ak sa generátor riadne skončí bez vrátenia hodnoty, metóda vráti null. Ak generátor ukončí nezachytená výnimka, nie je k dispozícii žiadny výsledok a neskoršie volanie getReturn() vyvolá \Exception. Pri delegovaní na iný generátor yield from odovzdáva jeho položky ďalej a hodnotou výrazu je jeho konečný výsledok. Vonkajší generátor ho môže vrátiť ako vlastný pomocou return yield from $inner;.
Príklady
<?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";
Výsledok
item: 4 item: 7 total: 11
`foreach` vypíše namerané hodnoty `4` a `7`. Až po skončení cyklu vráti `getReturn()` súčet `11`, ktorý nie je položkou iterácie.
Súvisiace lekcie
- PHP · Lekcia 59 · Pokročilá · Verzia: 2