WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / PHP

Schlüsselwort yield

Eine Funktion mit yield gibt einen Generator zurück, ohne den Rumpf sofort auszuführen.

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

Syntax

yield $key => $value;

Eine Funktion mit yield gibt einen Generator zurück, ohne den Rumpf sofort auszuführen. Jedes yield liefert Schlüssel und Wert und pausiert mit erhaltenem lokalen Zustand. Fortschalten setzt fort. Ein abschließendes return lässt sich nach normalem Abschluss separat per getReturn() lesen. send($v) setzt den Wert des angehaltenen yield-Ausdrucks auf $v und setzt den Generator fort. Der Aufrufer erhält den nächsten ausgegebenen Wert, getReturn() später das eigene Endergebnis.

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]

Beispiele

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

Ergebnis

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

Quellen