Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Python

Parametry `*args` i `**kwargs`: zbieranie i przekazywanie argumentów

W definicji funkcji `*args` zbiera pozostałe argumenty pozycyjne, a `**kwargs` — pozostałe argumenty nazwane. W wywołaniu te same znaki rozpakowują wartości, zamiast je zbierać.

Wersja: Python 3.12

Składnia

def wrapper(*args, **kwargs):
    return target(*args, **kwargs)

def dispatch(handler, /, *args, label="items"):
    return handler(*args, label=label)

W definicji funkcji w Pythonie 3.12 parametr *args zbiera argumenty pozycyjne, których nie przypisano innym parametrom, w krotkę, zachowując ich kolejność. Parametr **kwargs zbiera pozostałe argumenty nazwane w nowy słownik dict. Jeśli nie ma nic do zebrania, odpowiednie wartości to () i {}. args i kwargs to nazwy umowne; o zachowaniu decydują gwiazdki.

Zwykły parametr zadeklarowany po *args, taki jak label, można podać tylko przez nazwę. Samo * oznacza początek takich parametrów, ale nie zbiera argumentów. Jeśli podpis zawiera /, jak w przykładzie z handler, parametry przed nim można podawać tylko pozycyjnie. **kwargs, jeśli występuje, jest ostatnim parametrem.

W wywołaniu target(*args, **kwargs) operacja jest odwrotna: * rozpakowuje elementy obiektu iterowalnego jako osobne argumenty pozycyjne, a ** rozpakowuje odwzorowanie o kluczach będących napisami jako argumenty nazwane. Jawne podanie dwa razy tej samej nazwy argumentu w jednym wywołaniu powoduje SyntaxError na etapie kompilacji. Jeśli nazwa powtarza się w wyniku rozpakowania przez ** albo argument pozycyjny i nazwany przypisują wartości temu samemu parametrowi, podczas wykonywania wywołania powstaje TypeError.

Funkcja opakowująca wrapper zbiera argumenty obu rodzajów i przekazuje je dalej. Dyspozytor dispatch zbiera tylko nadmiarowe argumenty pozycyjne, przyjmuje label osobno i wywołuje handler. Jeśli przekażesz nazwę nieobsługiwaną przez dispatch, wywołanie zakończy się TypeError, mimo że wrapper ją przyjmie.

Przykłady

def render(*values, label):
    return f"{label}: {values}"


def dispatch(handler, /, *args, label="items"):
    return handler(*args, label=label)


def wrapper(*args, **kwargs):
    return dispatch(render, *args, **kwargs)


print(wrapper(3, 5, label="points"))
print(wrapper())

Wynik

points: (3, 5)
items: ()

W pierwszym wywołaniu `dispatch` przypisuje `label="points"` do parametru `label`, a `3` i `5` zbiera w `args`. W drugim `wrapper` nie ma czego zebrać, więc `dispatch` używa domyślnej wartości `"items"`.

Powiązane lekcje

  • Python · Lekcja 44 · Zaawansowany · Wersja: 5

Źródła