CKTIS / Python
Palavra-chave yield
Numa definição de função normal, yield faz com que a chamada crie um gerador sem executar imediatamente o corpo.
Versão: Python 3.14; repository image, production runtime not attested
Sintaxe
value = yield itemNuma definição de função normal, yield faz com que a chamada crie um gerador sem executar imediatamente o corpo.
Cada yield emite um valor e suspende a execução, preservando o estado local. A chamada send(x) fornece x como resultado da expressão yield suspensa e devolve o valor emitido a seguir, caso exista. Uma instrução return termina o gerador com o resultado em StopIteration.value. Um gerador novo inicia-se com next ou send(None), qualquer outro primeiro valor lança TypeError.
A expressão yield from encaminha send para o subgerador suspenso e recebe o seu valor de retorno.
Exemplos
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"
Resultado
ready 8 closed
A expressão yield from encaminha send para o subgerador suspenso e recebe o seu valor de retorno.