Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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

Źródła