KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Python

`*args` en `**kwargs`: argumenten verzamelen en doorgeven

In een definitie verzamelt `*args` overgebleven positionele argumenten en `**kwargs` overgebleven benoemde argumenten. Bij een aanroep pakken dezelfde sterretjes waarden uit.

Versie: Python 3.12

Syntax

def wrapper(*args, **kwargs):
    return target(*args, **kwargs)

def dispatch(handler, /, *args, label="items"):
    return handler(*args, label=label)

In een functiedefinitie in Python 3.12 verzamelt *args de positionele argumenten die niet aan andere parameters zijn gebonden in een tuple, in de volgorde waarin ze zijn doorgegeven. **kwargs verzamelt de overige benoemde argumenten in een nieuwe dict. Als er niets te verzamelen valt, krijgen ze respectievelijk () en {}. De namen args en kwargs zijn conventies; de sterretjes bepalen het gedrag.

Een gewone parameter na *args, zoals label, kun je alleen op naam doorgeven. Een losse * markeert het begin van zulke parameters maar verzamelt niets. Parameters vóór /, zoals handler in het voorbeeld, zijn uitsluitend positioneel. Als **kwargs aanwezig is, staat die parameter als laatste.

In een aanroep als target(*args, **kwargs) gebeurt het omgekeerde: * pakt een itereerbaar object uit tot afzonderlijke positionele argumenten, en ** pakt een mapping met tekenreeksen als sleutels uit tot benoemde argumenten. Geef je dezelfde argumentnaam twee keer expliciet op in één aanroep, dan krijg je tijdens het compileren een SyntaxError. Leidt uitpakken met ** tot een dubbele argumentnaam, of geven een positioneel en een benoemd argument allebei een waarde door voor dezelfde parameter, dan veroorzaakt de aanroep tijdens het uitvoeren een TypeError.

De wrapperfunctie wrapper verzamelt beide soorten argumenten en geeft ze door. De dispatcher dispatch verzamelt alleen extra positionele argumenten, ontvangt label apart en roept handler aan. Als dispatch een benoemd argument niet accepteert, veroorzaakt de doorgestuurde aanroep een TypeError, ook al accepteert wrapper het wel.

Voorbeelden

def render(*values, label):
    return f"{label}: {values}"


def dispatch(handler, /, *args, label="items"):
    return handler(*args, label=label)


def wrapper(*args, **kwargs):
    return dispatch(render, *args, **kwargs)


print(wrapper(3, 5, label="points"))
print(wrapper())

Resultaat

points: (3, 5)
items: ()

Bij de eerste aanroep bindt `dispatch` `label="points"` aan `label` en verzamelt het `3` en `5` in `args`. Bij de tweede aanroep heeft `wrapper` niets te verzamelen, dus gebruikt `dispatch` de standaardwaarde `"items"`.

Gerelateerde lessen

  • Python · Les 44 · Gevorderd · Versie: 5

Bronnen