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"]