Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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 item

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

Źródła