KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Python

Variadische positionele parameters: `*args`

In een functiedefinitie verzamelt `*args` extra positionele argumenten in een tuple. In een aanroep pakt `*` een itereerbaar object uit tot positionele argumenten.

Versie: Python 3.12

Syntax

def f(required, *args, option=False):
    ...

In Python 3.12 verzamelt *args in de definitie def f(required, *args, option=False): de positionele argumenten die niet aan eerdere parameters zijn gekoppeld, in de volgorde waarin ze zijn doorgegeven. Binnen de functie is args een tuple, of () als er geen extra argumenten zijn.

De naam args is een conventie; het voorvoegsel * geeft aan dat de parameter positionele argumenten verzamelt. Omdat option na *args staat, kun je het alleen via een sleutelwoord doorgeven, bijvoorbeeld als option=True. Een losse * leidt ook parameters in die alleen via een sleutelwoord kunnen worden ingevuld, maar verzamelt geen positionele argumenten.

In een definitie verzamelt één sterretje positionele argumenten; in een aanroep zoals func(*args, **kwargs) pakt het een itereerbaar object uit tot positionele argumenten. De wrapper gebruikt een apart mechanisme om sleutelwoordargumenten door te geven: in de definitie verzamelt **kwargs niet-toegewezen sleutelwoordargumenten in een dictionary; in de aanroep pakt ** een mapping met tekenreeksen als sleutels uit tot sleutelwoordargumenten. De signatuur van de doelfunctie blijft gelden: een ontbrekend verplicht argument of twee waarden voor dezelfde parameter leiden tot een TypeError.

Een auditwrapper kan de argumenten tellen, ze ongewijzigd doorgeven en het resultaat van de doelfunctie teruggeven. functools.wraps behoudt metadata zoals de naam van de oorspronkelijke functie. Log in echte auditlogs geen onbewerkte argumentwaarden: ze kunnen wachtwoorden of andere gevoelige gegevens bevatten.

Voorbeelden

from functools import wraps


def audit(func):
    @wraps(func)
    def wrapper(*args, **kwargs):
        print(f"audit: positional={len(args)}, keyword={len(kwargs)}")
        return func(*args, **kwargs)

    return wrapper


@audit
def total(base=0, *increments, scale=1):
    return (base + sum(increments)) * scale


print(total(10, 2, 3, scale=2))
print(total())

Resultaat

audit: positional=3, keyword=1
30
audit: positional=0, keyword=0
0

Bij de eerste aanroep telt de wrapper drie positionele argumenten en één sleutelwoordargument. Na het doorgeven koppelt `total` `10` aan `base`, `(2, 3)` aan `increments` en `2` aan `scale`, en geeft de functie `30` terug. De tweede aanroep toont beide lege verzamelingen (`()` en `{}`); de standaardwaarden leveren `0` op.

Gerelateerde lessen

  • Python · Les 10 · Gevorderd · Versie: 5

Bronnen