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