CKTIS / Python
Mot-clé yield
Dans une définition de fonction ordinaire, yield fait que l’appel crée un générateur sans exécuter aussitôt le corps.
Version : Python 3.14; repository image, production runtime not attested
Syntaxe
value = yield itemDans une définition de fonction ordinaire, yield fait que l’appel crée un générateur sans exécuter aussitôt le corps.
Chaque yield produit une valeur et suspend l’exécution en conservant l’état local. Un appel à send(x) fournit x comme résultat de l’expression yield suspendue et renvoie la prochaine valeur émise s’il y en a une. Une instruction return termine le générateur avec son résultat dans StopIteration.value. Un générateur neuf démarre par next ou send(None), toute autre première valeur lève TypeError.
Une expression yield from relaie send vers le sous-générateur suspendu et reçoit sa valeur de retour.
Exemples
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"
Résultat
ready 8 closed
Une expression yield from relaie send vers le sous-générateur suspendu et reçoit sa valeur de retour.