CKTIS / Python
Parametry wariadyczne `*args` i `**kwargs`
W Pythonie 3.12 parametr `*args` zbiera nadmiarowe argumenty pozycyjne do krotki, a `**kwargs` zbiera niedopasowane argumenty nazwane do słownika. Przy wywołaniu te same znaki służą do rozpakowywania argumentów.
Wersja: Python 3.12
Składnia
def f(first, *args, flag=False, **kwargs):
...W definicji funkcji *args zbiera argumenty pozycyjne, które nie zostały przypisane do wcześniejszych parametrów, w krotkę (tuple), zachowując ich kolejność. **kwargs zbiera argumenty nazwane, które nie pasują do jawnych parametrów przyjmujących argumenty nazwane, w nowy słownik (dict). Gdy nie ma nic do zebrania, wynikiem jest odpowiednio () lub {}. Nazwy args i kwargs są umowne: *items i **opts działają tak samo.
Parametr flag po *args można przekazać tylko po nazwie, np. flag=True. Samo * również wyznacza początek parametrów przyjmowanych wyłącznie po nazwie, ale nie zbiera argumentów. Jeśli definicja zawiera oba parametry zbierające, *args występuje przed **kwargs, a **kwargs jest na końcu listy parametrów.
Przy wywołaniu kierunek jest odwrotny: f(*items) przekazuje elementy obiektu iterowalnego jako osobne argumenty pozycyjne, a f(**opts) przekazuje wpisy mapowania o kluczach typu str jako argumenty nazwane. Przekazanie dwóch wartości temu samemu parametrowi lub podanie niedopasowanego argumentu nazwanego bez **kwargs powoduje TypeError. W tych kontekstach * i ** nie oznaczają mnożenia ani potęgowania.
Przykłady
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())Wynik
('scores', (10, 20))
('rows', ())
{'theme': 'dark'}
{}
Lista dostarcza do `compute_rows` dwa argumenty pozycyjne; `label` jest osobnym argumentem nazwanym. `build_config` zbiera `theme` w `opts`. Wywołania bez argumentów pokazują pustą krotkę i pusty słownik oraz domyślną wartość `label`.
Powiązane lekcje
- Python · Lekcja 18 · Średniozaawansowany · Wersja: 3