def

Définit une fonction : un bloc de code nommé, avec des paramètres, que vous pouvez appeler plusieurs fois.

Sur cette page

Exemple

#
Python
def award(name, exp=10, reason=None):
    """Renvoie la description des points attribués."""
    text = f"{name} : +{exp} EXP"
    if reason:
        text += f" ({reason})"
    return text

print(award("Emma"))
print(award("Jean", 25, reason="module terminé"))
Résultatrésultat enregistré, vous pouvez le vérifier
Emma : +10 EXP
Jean : +25 EXP (module terminé)

Définition et utilisation

#

Le mot-clé def crée une fonction. Après le nom, vous donnez les paramètres entre parenthèses, puis, après les deux-points, un bloc de code indenté. Vous appelez une fonction en écrivant son nom avec des parenthèses et des arguments.

Les paramètres peuvent avoir des valeurs par défaut (exp=10). Vous pouvez passer les arguments dans l’ordre ou par nom (award(name="Emma", exp=20)), ce qui améliore la lisibilité lorsqu’il y a beaucoup de paramètres.

La notation *args rassemble un nombre quelconque d’arguments positionnels dans un tuple, et **kwargs rassemble les arguments nommés dans un dictionnaire. La première ligne d’une fonction peut être une docstring, une chaîne qui décrit ce qu’elle fait.

Syntaxe

#
Syntaxe
def name(param, default=value, *args, **kwargs):
    ...

Plus d’exemples

#
*args et **kwargs
Python
def summary(*scores, **info):
    avg = sum(scores) / len(scores)
    return f"{info.get('name', 'Élève')} : moyenne de {avg:.1f} sur {len(scores)} tests"

print(summary(80, 95, 70, name="Mia"))
Résultatrésultat enregistré, vous pouvez le vérifier
Mia : moyenne de 81.7 sur 3 tests
Un piège : une valeur par défaut mutable
Python
def add_task(task, tasks=None):
    if tasks is None:
        tasks = []
    tasks.append(task)
    return tasks

print(add_task("HTML"))
print(add_task("CSS"))
Résultatrésultat enregistré, vous pouvez le vérifier
['HTML']
['CSS']

Bonnes pratiques

#
  • N’utilisez pas de valeurs par défaut mutables, comme [] ou {}. Elles sont créées une seule fois et partagées entre les appels. Utilisez None à la place.
  • Nommez les fonctions avec des verbes en snake_case, par exemple calculate_total.

Entrées associées

#

Pratiquer dans les leçons

#

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