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

CKTIS / Python

Paramètres variadiques : *args et **kwargs

Le paramètre *args rassemble les arguments positionnels supplémentaires dans un tuple, tandis que **kwargs rassemble les arguments nommés supplémentaires dans un dictionnaire. Ils permettent à une fonction d’accepter un nombre variable d’arguments.

Version : Python 3.14; repository image, production runtime not attested

Syntaxe

def function_name(*args, **kwargs):
    ...

Dans une définition de fonction, *args rassemble dans un tuple les arguments positionnels qui n’ont pas été attribués aux paramètres précédents. **kwargs rassemble dans un dictionnaire les arguments nommés qui n’ont pas été associés. En l’absence de tels arguments, ils reçoivent respectivement () et {}. Les noms args et kwargs sont conventionnels ; ce sont * et ** qui déterminent le comportement.

Vous pouvez utiliser l’un ou l’autre de ces paramètres, ou les deux. **kwargs doit être le dernier paramètre. Pour les paramètres ordinaires placés après *args, comme active dans l’exemple, seuls les arguments nommés sont autorisés. Si vous fournissez une valeur, vous devez donc indiquer le nom du paramètre. Si le paramètre a une valeur par défaut, vous pouvez l’omettre lors de l’appel. Un * seul introduit également des paramètres qui n’acceptent que des arguments nommés, mais ne rassemble pas les arguments positionnels.

Dans l’exemple, label reçoit le premier argument, args rassemble 10 et 20, active reçoit True, et kwargs ne contient que color. Lors du deuxième appel, args et kwargs sont vides. Comme active est omis, il prend sa valeur par défaut, False. Ne confondez pas le rassemblement dans une définition avec le dépaquetage de *values et **options dans un appel : dans ce cas, les opérateurs transmettent les éléments comme arguments séparés.

Identifiants de référence couverts par cette entrée : *args / **kwargs parameters.

Exemples

def collect(label, *args, active=False, **kwargs):
    print(label, args, active, kwargs)

collect("A", 10, 20, active=True, color="blue")
collect("B")

Résultat

A (10, 20) True {'color': 'blue'}
B () False {}

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources