Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Python

`*args` a `**kwargs`: sběr a předávání argumentů

V definici funkce `*args` sbírá zbývající poziční argumenty a `**kwargs` zbývající pojmenované argumenty. Při volání stejné hvězdičky naopak hodnoty rozbalují.

Verze: Python 3.12

Syntaxe

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

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

V definici funkce v Pythonu 3.12 sbírá *args poziční argumenty nepřiřazené jiným parametrům do n-tice v pořadí, v jakém byly předány. **kwargs sbírá zbývající pojmenované argumenty do nového slovníku dict. Pokud není co sbírat, dostanou postupně () a {}. Názvy args a kwargs jsou konvence; chování určují hvězdičky.

Běžný parametr za *args, například label, lze předat jen jménem. Samostatná * označuje začátek takových parametrů, ale nic nesbírá. Parametry před /, například handler v ukázce, lze předat jen pozičně. Pokud je uveden **kwargs, je to poslední parametr.

Při volání target(*args, **kwargs) se postup obrací: * rozbalí iterovatelný objekt na samostatné poziční argumenty a ** rozbalí mapování s řetězcovými klíči na pojmenované argumenty. Pokud je stejný název argumentu v jednom volání výslovně uveden dvakrát, vznikne při kompilaci SyntaxError. Pokud rozbalení pomocí ** způsobí opakování názvu argumentu nebo pokud poziční a pojmenovaný argument přiřadí hodnotu stejnému parametru, volání za běhu vyvolá TypeError.

Obalová funkce wrapper sbírá a předává argumenty obou druhů. Dispečerská funkce dispatch sbírá jen zbývající poziční argumenty, přijímá label zvlášť a volá handler. Pokud dispatch pojmenovaný argument nepřijímá, předané volání vyvolá TypeError, přestože ho wrapper přijme.

Příklady

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())

Výsledek

points: (3, 5)
items: ()

Při prvním volání `dispatch` přiřadí `label="points"` parametru `label` a sebere `3` a `5` do `args`. Při druhém volání nemá `wrapper` co sbírat, takže `dispatch` použije výchozí hodnotu `"items"`.

Související lekce

  • Python · Lekce 44 · Pokročilá · Verze: 5

Zdroje