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