Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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 item

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.

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.

Sources