CKTIS / Python
Słowo kluczowe yield
W zwykłej definicji funkcji obecność yield sprawia, że jej wywołanie tworzy generator bez natychmiastowego wykonania ciała.
Wersja: Python 3.14; repository image, production runtime not attested
Składnia
value = yield itemW zwykłej definicji funkcji obecność yield sprawia, że jej wywołanie tworzy generator bez natychmiastowego wykonania ciała.
Każde yield udostępnia wartość i zawiesza działanie, zachowując lokalny stan. Wywołanie send(x) przekazuje x jako wynik zawieszonego wyrażenia yield i zwraca następną wyemitowaną wartość, jeżeli taka istnieje. Instrukcja return kończy generator, umieszczając wynik w StopIteration.value. Nowy generator uruchamia się przez next lub send(None), a inna pierwsza wartość powoduje TypeError.
Wyrażenie yield from przekazuje send do zawieszonego podgeneratora i otrzymuje wartość jego return.
Przykłady
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"
Wynik
ready 8 closed
Wyrażenie yield from przekazuje send do zawieszonego podgeneratora i otrzymuje wartość jego return.