KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / PHP

Generator

Een generatorfunctie aanroepen maakt een onderbroken iterator.

Versie: PHP 8.4; repository runtime, production runtime not attested

Syntax

function sequence(): Generator { yield $value; }

Een generatorfunctie aanroepen maakt een onderbroken iterator. Doorschakelen hervat na yield. De return-waarde staat los van de afgegeven elementen. getReturn werkt na normale voltooiing en geeft null bij doorlopen tot het einde. Vóór voltooiing of na afbreken door een uitzondering werpt het Exception. Een uitgeputte generator is doorgaans niet terug te spoelen voor hergebruik. Na verbruik van beide waarden leest Generator::getReturn de 5 uit de return van de generator.

function sequence(): Generator { yield "a"=>2; yield "b"=>3; return 5; }
$g=sequence(); $items=iterator_to_array($g); echo json_encode([$items,$g->getReturn(),$g->valid()]);
function aborted(): Generator { yield 1; throw new RuntimeException("stopped"); }
$bad=aborted(); try{$bad->getReturn();}catch(Exception $e){$early=get_class($e);} try{iterator_to_array($bad);}catch(RuntimeException $e){}
try{$bad->getReturn();}catch(Exception $e){$late=get_class($e);} echo PHP_EOL,json_encode([$early,$late]);
[{"a":2,"b":3},5,false]
["Exception","Exception"]

Voorbeelden

<?php
function sequence(): Generator { yield "a"=>2; yield "b"=>3; return 5; }
$g=sequence(); $items=iterator_to_array($g); echo json_encode([$items,$g->getReturn(),$g->valid()]);
function aborted(): Generator { yield 1; throw new RuntimeException("stopped"); }
$bad=aborted(); try{$bad->getReturn();}catch(Exception $e){$early=get_class($e);} try{iterator_to_array($bad);}catch(RuntimeException $e){}
try{$bad->getReturn();}catch(Exception $e){$late=get_class($e);} echo PHP_EOL,json_encode([$early,$late]);

Resultaat

[{"a":2,"b":3},5,false]
["Exception","Exception"]

Bronnen