CKTIS / Python
Variadické parametry `*args` a `**kwargs`
V Pythonu 3.12 shromažďuje `*args` přebytečné poziční argumenty do n-tice a `**kwargs` nepřiřazené pojmenované argumenty do slovníku. Při volání stejné znaky argumenty rozbalují.
Verze: Python 3.12
Syntaxe
def f(first, *args, flag=False, **kwargs):
...V definici funkce *args shromáždí do n-tice (tuple) v původním pořadí poziční argumenty, které nebyly přiřazeny předchozím parametrům. **kwargs shromáždí do nového slovníku (dict) pojmenované argumenty, které neodpovídají žádnému deklarovanému parametru, jenž je může přijmout. Pokud není co shromáždit, vznikne (), respektive {}. Názvy args a kwargs jsou jen zvyklost: *items a **opts fungují stejně.
Parametr jako flag uvedený za *args lze předat pouze jménem, například flag=True. Samostatná hvězdička * také uvozuje parametry předávané pouze jménem, ale žádné argumenty neshromažďuje. Pokud jsou v definici oba variadické parametry, *args stojí před **kwargs a **kwargs je poslední.
Při volání je směr opačný: f(*items) rozbalí iterovatelný objekt na samostatné poziční argumenty a f(**opts) rozbalí položky mapování s klíči typu str na pojmenované argumenty. Předání dvou hodnot témuž parametru nebo pojmenovaného argumentu bez odpovídajícího parametru, pokud chybí **kwargs, vyvolá TypeError. V těchto kontextech * a ** neznamenají násobení ani umocňování.
Příklady
def compute_rows(*items, label="rows"):
return label, items
def build_config(**opts):
return opts
print(compute_rows(*[10, 20], label="scores"))
print(compute_rows())
print(build_config(**{"theme": "dark"}))
print(build_config())Výsledek
('scores', (10, 20))
('rows', ())
{'theme': 'dark'}
{}
Seznam předá funkci `compute_rows` dva poziční argumenty; `label` se předává zvlášť jménem. Funkce `build_config` uloží `theme` do `opts`. Volání bez argumentů ukazují prázdnou n-tici a slovník i výchozí hodnotu parametru `label`.
Související lekce
- Python · Lekce 18 · Středně pokročilá · Verze: 3