Accueil › Python › Écrire une fonction : def, paramètres, retour
Écrire une fonction : def, paramètres, retour
Boucles, fonctions et compréhensionsdebutant
Une fonction nomme un morceau de code, lui donne des entrées et une sortie.
def prix_ttc(prix_ht: float, taux_tva: float = 0.20) -> float:
"""Renvoie le prix toutes taxes comprises, arrondi au centime."""
return round(prix_ht * (1 + taux_tva), 2)
print(prix_ttc(100)) # 120.0
print(prix_ttc(100, 0.055)) # 105.5
Quatre points à retenir tout de suite :
defcrée la fonction ; le corps ne s'exécute qu'à l'appel.returnrenvoie une valeur et quitte la fonction sur-le-champ.- Sans
return, la fonction renvoieNone.printn'est pasreturn: afficher n'est pas renvoyer. - La docstring — la chaîne en première ligne du corps — dit ce que la fonction renvoie, pas comment elle s'y prend.
Les annotations de type (prix_ht: float, -> float) sont facultatives et non vérifiées à l'exécution : elles documentent, et un outil comme mypy les contrôle hors exécution.
Une fonction bien écrite fait une chose, et son nom le dit : prix_ttc, pas traiter.
Les termes à connaître
- def
Mot-clé qui définit une fonction. L'exécuter ne fait rien d'autre que créer un objet fonction et le lier à un nom. Le corps n'est exécuté qu'à l'appel.
- Paramètre / argument
Le paramètre est le nom déclaré dans la signature (
def total(prix, quantite)). L'argument est la valeur réellement passée à l'appel (total(1.2, 3)). La distinction est attendue en entretien.- return
Renvoie une valeur et quitte la fonction immédiatement. Une fonction sans
return, ou dont lereturnest nu, renvoieNone.- None
La valeur « rien » de Python. C'est ce que renvoie toute fonction qui ne renvoie rien explicitement — y compris
print,list.appendoulist.sort. D'où le classiqueliste = liste.sort()qui metNonedans la variable.- Docstring
Chaîne littérale placée en première instruction du corps de la fonction. Elle devient
fonction.__doc__et alimentehelp(fonction). Un commentaire#au même endroit n'a aucun de ces effets.- Annotation de type
Indication facultative de type :
def total(prix: float, quantite: int) -> float:. Python ne l'applique pas à l'exécution — c'est de la documentation lisible par un vérificateur comme mypy. Depuis Python 3.9 on écritlist[str], plusList[str].- Clause de garde (early return)
Traiter les cas d'exception en tête de fonction avec un
returnimmédiat, pour laisser le cas normal au premier niveau d'indentation. C'est le principal remède aux fonctions en escalier.
Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.