Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Python

Paramètres variadiques `*args` et `**kwargs`

En Python 3.12, `*args` recueille les arguments positionnels supplémentaires dans un tuple et `**kwargs` les arguments nommés non associés dans un dictionnaire. Lors d’un appel, ces mêmes symboles déballent les arguments.

Version : Python 3.12

Syntaxe

def f(first, *args, flag=False, **kwargs):
    ...

Dans une définition de fonction, *args recueille dans un tuple (tuple), dans leur ordre d’arrivée, les arguments positionnels qui n’ont pas été associés aux paramètres précédents. **kwargs recueille dans un nouveau dictionnaire (dict) les arguments nommés qui ne correspondent à aucun paramètre déclaré pouvant les recevoir. S’il n’y a rien à recueillir, on obtient respectivement () et {}. Les noms args et kwargs sont des conventions : *items et **opts fonctionnent de la même façon.

Un paramètre comme flag placé après *args ne peut être passé que par son nom, par exemple flag=True. Un * seul introduit également des paramètres de ce type, mais ne recueille aucun argument. Si les deux paramètres variadiques sont présents, *args précède **kwargs, et **kwargs est le dernier paramètre.

Lors d’un appel, le sens est inverse : f(*items) décompose un itérable en arguments positionnels distincts, et f(**opts) transforme les entrées d’une table associative à clés de type str en arguments nommés. Donner deux valeurs au même paramètre ou passer un argument nommé sans paramètre correspondant en l’absence de **kwargs déclenche TypeError. Dans ces contextes, * et ** ne désignent ni la multiplication ni l’élévation à une puissance.

Exemples

def compute_rows(*items, label="rows"):
    return label, items


def build_config(**opts):
    return opts


print(compute_rows(*[10, 20], label="scores"))
print(compute_rows())
print(build_config(**{"theme": "dark"}))
print(build_config())

Résultat

('scores', (10, 20))
('rows', ())
{'theme': 'dark'}
{}

La liste fournit deux arguments positionnels à `compute_rows` ; `label` est transmis séparément par son nom. `build_config` recueille `theme` dans `opts`. Les appels sans arguments montrent le tuple et le dictionnaire vides, ainsi que la valeur par défaut de `label`.

Leçons associées

  • Python · Leçon 18 · Intermédiaire · Version : 3

Sources