Formations — 1 037 leçons en français

Accueil › Python › Arguments : valeurs par défaut, *args, **kwargs

Arguments : valeurs par défaut, *args, **kwargs

Boucles, fonctions et compréhensionsdebutant

Une valeur par défaut rend un argument facultatif :

def facturer(montant: float, devise: str = "EUR") -> str:
    return f"{montant:.2f} {devise}"

Elle est évaluée une seule fois, à la définition de la fonction. D'où la règle la plus importante de cette leçon : jamais de valeur par défaut mutable (liste, dict, set). Écrivez None et créez l'objet à l'intérieur :

def ajouter(produit, panier: list[str] | None = None) -> list[str]:
    if panier is None:
        panier = []
    panier.append(produit)
    return panier

Deux étoiles permettent d'accepter un nombre quelconque d'arguments :

def journaliser(message, *details, **champs):
    print(message, details, champs)

journaliser("commande", "C-1042", 3, client="Dupont", urgent=True)
# commande ('C-1042', 3) {'client': 'Dupont', 'urgent': True}

*details est un tuple, **champs un dictionnaire.

Enfin, une * nue force les paramètres suivants à être nommés :

def exporter(chemin, *, entetes=True, separateur=";"):
    ...

exporter("ventes.csv", entetes=False)   # exporter("ventes.csv", False) est refusé

Les termes à connaître

Valeur par défaut

Valeur utilisée quand l'argument n'est pas fourni : def facturer(montant, devise="EUR"). Elle est évaluée une seule fois, au moment où le def est exécuté — pas à chaque appel. C'est toute l'origine du piège du défaut mutable.

Argument nommé (keyword argument)

Argument passé par son nom plutôt que par sa position : facturer(montant=10, devise="USD"). Il rend l'appel lisible et le protège d'un changement d'ordre dans la signature.

*args

Collecte les arguments positionnels surnuméraires dans un tuple. Le nom args est une convention ; c'est l'étoile qui fait le travail.

**kwargs

Collecte les arguments nommés surnuméraires dans un dictionnaire {nom: valeur}. Sert surtout à transmettre des options à une autre fonction sans les énumérer.

Paramètre keyword-only

Paramètre qui ne peut être passé que par son nom. Tout ce qui suit une * nue dans la signature l'est : def exporter(chemin, *, separateur=";"). Idéal pour les options booléennes, qu'on ne veut jamais lire comme un True anonyme.

Paramètre positional-only

Paramètre qui ne peut pas être passé par son nom. Tout ce qui précède un / dans la signature l'est (Python 3.8+) : def distance(x, y, /):. Cela laisse la liberté de renommer les paramètres plus tard sans casser les appels.

Déballage à l'appel

f(*liste) passe chaque élément comme argument positionnel ; f(**dico) passe chaque paire comme argument nommé. C'est l'opération inverse de *args / **kwargs.

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.