CKTIS / PHP
Generator
Appeler une fonction génératrice crée un itérateur suspendu.
Version : PHP 8.4; repository runtime, production runtime not attested
Syntaxe
function sequence(): Generator { yield $value; }Appeler une fonction génératrice crée un itérateur suspendu. Avancer reprend après yield. Le résultat de return est distinct des éléments émis. getReturn réussit après achèvement normal et donne null si le corps atteint sa fin. Avant la fin ou après un arrêt par exception, il lève Exception. Un générateur épuisé ne se parcourt généralement pas de nouveau. Après consommation des deux valeurs, Generator::getReturn lit le 5 renvoyé par le return du générateur.
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"]
Exemples
<?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]);
Résultat
[{"a":2,"b":3},5,false]
["Exception","Exception"]