Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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

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

Izvori