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