CKTIS / Python
Schlüsselwort yield
In einer gewöhnlichen Funktionsdefinition bewirkt yield, dass der Aufruf einen Generator erzeugt, ohne den Rumpf sofort auszuführen.
Version: Python 3.14; repository image, production runtime not attested
Syntax
value = yield itemIn einer gewöhnlichen Funktionsdefinition bewirkt yield, dass der Aufruf einen Generator erzeugt, ohne den Rumpf sofort auszuführen.
Jedes yield liefert einen Wert und unterbricht die Ausführung unter Erhaltung des lokalen Zustands. Ein Aufruf von send(x) setzt x als Ergebnis des angehaltenen yield-Ausdrucks ein und gibt, falls vorhanden, den nächsten erzeugten Wert zurück. Eine Rückgabe mit return beendet den Generator mit dem Ergebnis in StopIteration.value. Ein neuer Generator startet mit next oder send(None), ein anderer erster Wert löst TypeError aus.
Der Ausdruck yield from leitet send an den angehaltenen Untergenerator weiter und erhält dessen Rückgabewert.
Beispiele
def exchange():
response = yield "ready"
yield response * 2
return "closed"
g = exchange()
print(next(g), g.send(4))
try:
next(g)
except StopIteration as end:
print(end.value)
def relay():
done = yield from exchange()
yield "child " + done
g = relay()
try:
g.send(3)
except TypeError:
pass
else:
raise AssertionError("unprimed generator")
assert g.send(None) == "ready" and g.send(3) == 6 and next(g) == "child closed"
Ergebnis
ready 8 closed
Der Ausdruck yield from leitet send an den angehaltenen Untergenerator weiter und erhält dessen Rückgabewert.