Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / PHP

Słowo kluczowe yield

Funkcja zawierająca yield zwraca Generator bez natychmiastowego wykonania ciała.

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

Składnia

yield $key => $value;

Funkcja zawierająca yield zwraca Generator bez natychmiastowego wykonania ciała. Przy yield udostępnia klucz i wartość, po czym zawiesza się z zachowaniem zmiennych lokalnych. Przesunięcie generatora wznawia pracę. Końcowy return odczytuje się osobno przez getReturn() po normalnym zakończeniu. send($v) nadaje wartość $v samemu zawieszonemu wyrażeniu yield i wznawia generator. Wywołujący dostaje następną wyemitowaną wartość, a getReturn() później zwraca oddzielny wynik końcowy.

function stream(&$trace){$trace[]="start"; yield "a"=>2; $trace[]="resume"; return 5;}
$t=[]; $g=stream($t); $initial=$t; $values=iterator_to_array($g); echo json_encode([$initial,$values,$t,$g->getReturn()]);
function channel(){ $n=yield "ready"; yield $n*2; return $n+1; } $ch=channel(); $start=$ch->current(); $sent=$ch->send(5); $ch->next(); echo "\n",json_encode([$start,$sent,$ch->getReturn()]);
[[],{"a":2},["start","resume"],5]
["ready",10,6]

Przykłady

<?php
function stream(&$trace){$trace[]="start"; yield "a"=>2; $trace[]="resume"; return 5;}
$t=[]; $g=stream($t); $initial=$t; $values=iterator_to_array($g); echo json_encode([$initial,$values,$t,$g->getReturn()]);
function channel(){ $n=yield "ready"; yield $n*2; return $n+1; } $ch=channel(); $start=$ch->current(); $sent=$ch->send(5); $ch->next(); echo "\n",json_encode([$start,$sent,$ch->getReturn()]);

Wynik

[[],{"a":2},["start","resume"],5]
["ready",10,6]

Źródła