Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / PHP

Mot-clé yield

Une fonction contenant yield renvoie un Generator sans exécuter immédiatement son corps.

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

Syntaxe

yield $key => $value;

Une fonction contenant yield renvoie un Generator sans exécuter immédiatement son corps. Chaque yield expose une clé et une valeur puis suspend les variables locales en place. Avancer reprend l’exécution. Un return final se lit séparément avec getReturn() après la fin normale. send($v) fait de $v le résultat du yield suspendu et reprend le générateur. L’appelant reçoit la valeur émise suivante, getReturn() donne ensuite le résultat final distinct.

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]

Exemples

<?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()]);

Résultat

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

Sources