WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Python

Variadische Parameter `*args` und `**kwargs`

In Python 3.12 sammelt `*args` zusätzliche Positionsargumente in einem Tupel und `**kwargs` nicht zugeordnete Schlüsselwortargumente in einem Wörterbuch. Beim Aufruf packen dieselben Zeichen Argumente aus.

Version: Python 3.12

Syntax

def f(first, *args, flag=False, **kwargs):
    ...

In einer Funktionsdefinition sammelt *args alle Positionsargumente, die keinem vorherigen Parameter zugeordnet wurden, der Reihe nach in einem Tupel (tuple). **kwargs sammelt Schlüsselwortargumente, die keinem dafür vorgesehenen deklarierten Parameter entsprechen, in einem neuen Wörterbuch (dict). Gibt es nichts zu sammeln, erhält man () beziehungsweise {}. Die Namen args und kwargs sind Konvention: *items und **opts funktionieren genauso.

Ein Parameter wie flag nach *args kann nur per Schlüsselwort übergeben werden, etwa als flag=True. Ein alleinstehendes * leitet solche Parameter ebenfalls ein, sammelt aber keine Argumente. Sind beide Sammelparameter vorhanden, steht *args vor **kwargs; **kwargs steht am Ende der Parameterliste.

Beim Aufruf ist es umgekehrt: f(*items) gibt die Elemente eines iterierbaren Objekts als einzelne Positionsargumente weiter, und f(**opts) verwendet die Einträge eines Mappings mit str-Schlüsseln als Schlüsselwortargumente. Zwei Werte für denselben Parameter oder ein nicht zuordenbares Schlüsselwortargument ohne **kwargs führen zu TypeError. In diesen Kontexten sind * und ** keine Operatoren für Multiplikation oder Potenzierung.

Beispiele

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())

Ergebnis

('scores', (10, 20))
('rows', ())
{'theme': 'dark'}
{}

Die Liste liefert `compute_rows` zwei Positionsargumente; `label` wird separat per Schlüsselwort übergeben. `build_config` sammelt `theme` in `opts`. Die Aufrufe ohne Argumente zeigen das leere Tupel und Wörterbuch sowie den Standardwert für `label`.

Zugehörige Lektionen

  • Python · Lektion 18 · Mittlere Stufe · Version: 3

Quellen