Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Python

Parametri posizionali variadici: `*args`

Nella definizione di una funzione, `*args` raccoglie gli argomenti posizionali in eccesso in una tupla. In una chiamata, `*` spacchetta un iterabile in argomenti posizionali.

Versione: Python 3.12

Sintassi

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

In Python 3.12, nella definizione def f(required, *args, option=False):, *args raccoglie, nell’ordine in cui sono stati passati, gli argomenti posizionali che non sono stati associati ai parametri precedenti. Nel corpo della funzione, args è una tupla, oppure () se non ci sono argomenti in eccesso.

Il nome args è convenzionale; il prefisso * indica che il parametro raccoglie argomenti posizionali. Poiché option segue *args, può essere passato solo per nome, ad esempio con option=True. Anche un * da solo introduce parametri da passare solo per nome, ma non raccoglie argomenti posizionali.

In una definizione, un solo asterisco raccoglie gli argomenti posizionali; in una chiamata come func(*args, **kwargs), spacchetta un iterabile in argomenti posizionali. Il wrapper usa un meccanismo distinto per inoltrare gli argomenti per nome: nella definizione, **kwargs raccoglie in un dizionario gli argomenti per nome non associati; nella chiamata, ** spacchetta un mapping con chiavi di tipo stringa in argomenti per nome. La firma della funzione di destinazione resta valida: se manca un argomento obbligatorio o si forniscono due valori per lo stesso parametro, si verifica un TypeError.

Una funzione wrapper di audit può contare gli argomenti, inoltrarli senza modifiche e restituire il risultato della funzione di destinazione. functools.wraps conserva metadati come il nome della funzione originale. Nei registri di audit reali, evita di registrare i valori degli argomenti così come sono: potrebbero contenere password o altri dati sensibili.

Esempi

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

Risultato

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

Alla prima chiamata, il wrapper conta tre argomenti posizionali e uno per nome. Dopo l’inoltro, `total` associa `10` a `base`, `(2, 3)` a `increments` e `2` a `scale`, restituendo `30`. La seconda chiamata mostra entrambe le collezioni vuote (`()` e `{}`); i valori predefiniti danno `0`.

Lezioni correlate

  • Python · Lezione 10 · Avanzato · Versione: 5

Fonti