WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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 item

In 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.

Quellen