WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Python

Variadische Positionsparameter: `*args`

In einer Funktionsdefinition sammelt `*args` zusätzliche Positionsargumente in einem Tupel. Beim Aufruf entpackt `*` ein iterierbares Objekt in Positionsargumente.

Version: Python 3.12

Syntax

def f(required, *args, option=False):
    ...

In Python 3.12 sammelt *args in der Definition def f(required, *args, option=False): alle Positionsargumente, die keinem vorhergehenden Parameter zugeordnet wurden, in der Reihenfolge ihrer Übergabe. Im Funktionsrumpf ist args ein Tupel, ohne zusätzliche Argumente also ().

Der Name args ist Konvention; das Präfix * kennzeichnet den Parameter, der Positionsargumente sammelt. Weil option hinter *args steht, kann es nur per Schlüsselwort übergeben werden, etwa als option=True. Ein alleinstehendes * leitet ebenfalls solche Parameter ein, sammelt aber keine Positionsargumente.

In einer Definition sammelt ein einzelner Stern Positionsargumente, bei einem Aufruf wie func(*args, **kwargs) entpackt er dagegen ein iterierbares Objekt in Positionsargumente. Für die Weitergabe von Schlüsselwortargumenten nutzt der Wrapper einen eigenen Mechanismus: In der Definition sammelt **kwargs nicht zugeordnete Schlüsselwortargumente in einem Wörterbuch; beim Aufruf entpackt ** ein Mapping mit Zeichenketten als Schlüsseln in Schlüsselwortargumente. Die Signatur der Zielfunktion gilt weiterhin: Ein fehlendes Pflichtargument oder zwei Werte für denselben Parameter führen zu TypeError.

Eine Audit-Wrapperfunktion kann Argumente zählen, unverändert weitergeben und das Ergebnis der Zielfunktion zurückgeben. functools.wraps erhält Metadaten wie den Namen der ursprünglichen Funktion. Protokolliere in echten Audit-Logs keine rohen Argumentwerte: Sie können Passwörter oder andere sensible Daten enthalten.

Beispiele

from functools import wraps


def audit(func):
    @wraps(func)
    def wrapper(*args, **kwargs):
        print(f"audit: positional={len(args)}, keyword={len(kwargs)}")
        return func(*args, **kwargs)

    return wrapper


@audit
def total(base=0, *increments, scale=1):
    return (base + sum(increments)) * scale


print(total(10, 2, 3, scale=2))
print(total())

Ergebnis

audit: positional=3, keyword=1
30
audit: positional=0, keyword=0
0

Beim ersten Aufruf zählt der Wrapper drei Positionsargumente und ein Schlüsselwortargument. Nach der Weitergabe bindet `total` `10` an `base`, `(2, 3)` an `increments` und `2` an `scale` und gibt `30` zurück. Der zweite Aufruf zeigt beide leeren Sammlungen (`()` und `{}`); die Standardwerte ergeben `0`.

Zugehörige Lektionen

  • Python · Lektion 10 · Fortgeschritten · Version: 5

Quellen