CKTIS / PHP
Generator::getReturn — leggere il valore restituito da un generatore
Recupera il risultato finale di un generatore dopo che si è concluso normalmente. Il valore di `return` è distinto dagli elementi prodotti da `yield`.
Versione: PHP 8.3
Sintassi
public function Generator::getReturn(): mixedGenerator::getReturn è un metodo pubblico di istanza della classe integrata \Generator, disponibile da PHP 7.0. Non richiede alcuna estensione opzionale. Chiamalo senza argomenti con $generator->getReturn(). La chiamata a una funzione generatrice restituisce un oggetto \Generator; il tipo di ritorno mixed nella firma mostrata per PHP 8.3 descrive il valore finale del generatore, non il tipo di quell’oggetto.
yield fornisce un elemento all’iterazione e sospende l’esecuzione. return termina il generatore e il suo valore non diventa un altro elemento di foreach. Dopo aver completato il ciclo, leggi il risultato dallo stesso oggetto. Ricevere l’ultimo elemento non basta: un break può lasciare il generatore sospeso su un yield, e chiamare il metodo in quello stato lancia una \Exception.
Se il generatore termina normalmente senza restituire un valore, il metodo restituisce null. Se un’eccezione non intercettata termina il generatore, non c’è alcun risultato da leggere e una successiva chiamata a getReturn() lancia una \Exception. Quando si delega a un altro generatore, yield from inoltra i suoi elementi e ha come valore il suo risultato finale. Il generatore esterno può restituire quel valore come proprio con return yield from $inner;.
Esempi
<?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";
Risultato
item: 4 item: 7 total: 11
`foreach` stampa le letture `4` e `7`. Solo dopo il ciclo `getReturn()` fornisce il totale `11`, che non è un elemento dell’iterazione.
Lezioni correlate
- PHP · Lezione 59 · Avanzato · Versione: 2