yield

Crée un générateur : une fonction qui renvoie des valeurs successives à la demande.

Sur cette page

Exemple

#
Python
def levels(start, stop):
    level = start
    while level <= stop:
        yield level, level * 100
        level += 1

for level, exp in levels(1, 3):
    print(f"Niveau {level} : {exp} EXP")

gen = levels(5, 6)
print(next(gen))
Résultatrésultat enregistré, vous pouvez le vérifier
Niveau 1 : 100 EXP
Niveau 2 : 200 EXP
Niveau 3 : 300 EXP
(5, 500)

Définition et utilisation

#

Une fonction contenant yield devient un générateur. Au lieu de renvoyer un seul résultat et de se terminer, elle « fait une pause » à chaque yield, rend une valeur et reprend lorsqu’on lui demande la suivante.

Les générateurs produisent les éléments paresseusement, les uns après les autres. Grâce à cela, vous pouvez traiter de très grosses données, par exemple les lignes d’un énorme fichier, sans tout charger en mémoire, et même décrire des suites infinies.

Vous parcourez un générateur avec une boucle for, ou vous récupérez les valeurs successives avec la fonction next(). La notation yield from other transmet chaque valeur d’un autre générateur ou d’une autre collection.

Syntaxe

#
Syntaxe
def generator():
    yield value

Bonnes pratiques

#
  • Un générateur ne peut être parcouru qu’une seule fois. Si vous avez besoin des données plusieurs fois, convertissez-le en liste avec list().
  • Pour les générateurs simples, une expression génératrice suffit : (x * x for x in numbers).

Entrées associées

#

Pratiquer dans les leçons

#

Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.