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

CKTIS / Python

Variadické poziční parametry: `*args`

V definici funkce `*args` shromažďuje přebytečné poziční argumenty do n-tice. Při volání `*` rozbalí iterovatelný objekt na poziční argumenty.

Verze: Python 3.12

Syntaxe

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

V Pythonu 3.12 v definici def f(required, *args, option=False): parametr *args shromažďuje v pořadí předání poziční argumenty, které se nepřiřadily k předchozím parametrům. V těle funkce je args n-tice, nebo (), pokud žádné argumenty nezbyly.

Název args je konvence; předpona * označuje parametr, který shromažďuje poziční argumenty. Protože je option za *args, lze jej zadat pouze jménem, například option=True. Samostatná hvězdička * také uvádí parametry zadávané pouze jménem, ale neshromažďuje poziční argumenty.

V definici jedna hvězdička shromažďuje poziční argumenty; při volání jako func(*args, **kwargs) rozbalí iterovatelný objekt na poziční argumenty. K předávání pojmenovaných argumentů používá obalová funkce samostatný mechanismus: v definici **kwargs shromažďuje nepřiřazené pojmenované argumenty do slovníku, zatímco při volání ** rozbalí mapování s řetězcovými klíči na pojmenované argumenty. Signatura cílové funkce platí i nadále: chybějící povinný argument nebo dvě hodnoty pro tentýž parametr způsobí TypeError.

Obalová funkce pro audit může argumenty spočítat, beze změny předat dál a vrátit výsledek cílové funkce. functools.wraps zachovává metadata, například název původní funkce. Do skutečných auditních protokolů nezapisuj hodnoty argumentů tak, jak přišly: mohou obsahovat hesla nebo jiné citlivé údaje.

Příklady

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

Výsledek

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

Při prvním volání obalová funkce napočítá tři poziční argumenty a jeden pojmenovaný. Po předání funkce `total` přiřadí `10` k `base`, `(2, 3)` k `increments` a `2` k `scale` a vrátí `30`. Druhé volání ukazuje obě prázdné kolekce (`()` a `{}`); výchozí hodnoty dají `0`.

Související lekce

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

Zdroje