CKTIS / PHP
Generator
Извикване на генераторна функция създава спрян итератор.
Версия: PHP 8.4; repository runtime, production runtime not attested
Синтаксис
function sequence(): Generator { yield $value; }Извикване на генераторна функция създава спрян итератор. Следваща стъпка възобновява работата след yield. Резултатът на return е отделен от подадените елементи. getReturn работи след нормално завършване и дава null при достигане края на тялото. Преди края или след прекратяване с изключение хвърля Exception. Изчерпан генератор по принцип не се превърта за повторна употреба. След изчерпване на двете стойности Generator::getReturn чете числото 5 от инструкцията return на генератора.
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"]
Примери
<?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]);
Резултат
[{"a":2,"b":3},5,false]
["Exception","Exception"]