Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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 item

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

Fontes