Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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(): mixed

Generator::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

Viri