Formations — 1 037 leçons en français

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 :

  1. def crée la fonction ; le corps ne s'exécute qu'à l'appel.
  2. return renvoie une valeur et quitte la fonction sur-le-champ.
  3. Sans return, la fonction renvoie None. print n'est pas return : afficher n'est pas renvoyer.
  4. 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 le return est nu, renvoie None.

None

La valeur « rien » de Python. C'est ce que renvoie toute fonction qui ne renvoie rien explicitement — y compris print, list.append ou list.sort. D'où le classique liste = liste.sort() qui met None dans la variable.

Docstring

Chaîne littérale placée en première instruction du corps de la fonction. Elle devient fonction.__doc__ et alimente help(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 écrit list[str], plus List[str].

Clause de garde (early return)

Traiter les cas d'exception en tête de fonction avec un return immédiat, pour laisser le cas normal au premier niveau d'indentation. C'est le principal remède aux fonctions en escalier.

Lire l'explication détaillée et faire le quiz →

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.