KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Python

Variadische parameters: *args en **kwargs

De parameter *args verzamelt extra positionele argumenten in een tuple, terwijl **kwargs extra benoemde argumenten in een dictionary verzamelt. Zo kan een functie een variabel aantal argumenten accepteren.

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

Syntax

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

In een functiedefinitie verzamelt *args positionele argumenten die niet aan eerdere parameters zijn toegewezen in een tuple. **kwargs verzamelt niet-toegewezen benoemde argumenten in een dictionary. Als zulke argumenten ontbreken, krijgen ze respectievelijk () en {}. De namen args en kwargs zijn conventies; * en ** bepalen het gedrag.

Je kunt een van beide parameters gebruiken of allebei. **kwargs moet de laatste parameter zijn. Gewone parameters na *args, zoals active in het voorbeeld, accepteren alleen benoemde argumenten. Als je een waarde opgeeft, moet je die met de parameternaam doorgeven. Heeft de parameter een standaardwaarde, dan kun je hem bij de aanroep weglaten. Een losse * leidt ook parameters in die alleen benoemde argumenten accepteren, maar verzamelt geen positionele argumenten.

In het voorbeeld ontvangt label het eerste argument, verzamelt args 10 en 20, ontvangt active True en bevat kwargs alleen color. Bij de tweede aanroep zijn args en kwargs leeg. Omdat active wordt weggelaten, krijgt die parameter de standaardwaarde False. Verwar het verzamelen in een definitie niet met het uitpakken van *values en **options in een aanroep: daar geven de operatoren de elementen als afzonderlijke argumenten door.

Referentie-identificatoren die in dit item worden behandeld: *args / **kwargs parameters.

Voorbeelden

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

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

Resultaat

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

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen