Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Python

Parametri variadici `*args` e `**kwargs`

In Python 3.12, `*args` raccoglie gli argomenti posizionali in più in una tupla e `**kwargs` gli argomenti per nome senza corrispondenza in un dizionario. In una chiamata, gli stessi simboli espandono gli argomenti.

Versione: Python 3.12

Sintassi

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

Nella definizione di una funzione, *args raccoglie in una tupla (tuple), mantenendone l’ordine, gli argomenti posizionali non assegnati ai parametri precedenti. **kwargs raccoglie in un nuovo dizionario (dict) gli argomenti per nome che non corrispondono ad alcun parametro dichiarato che possa riceverli. Se non c’è nulla da raccogliere, si ottengono rispettivamente () e {}. I nomi args e kwargs sono convenzionali: *items e **opts funzionano allo stesso modo.

Un parametro come flag dopo *args può essere passato solo per nome, ad esempio con flag=True. Un * senza nome introduce anch’esso parametri di questo tipo, ma non raccoglie argomenti. Se sono presenti entrambi i parametri variadici, *args precede **kwargs, che chiude l’elenco dei parametri.

In una chiamata il verso è opposto: f(*items) espande un iterabile in argomenti posizionali distinti e f(**opts) espande le voci di una mappatura con chiavi di tipo str in argomenti per nome. Passare due valori allo stesso parametro o passare un argomento per nome senza corrispondenza in assenza di **kwargs genera TypeError. In questi contesti, * e ** non indicano moltiplicazione o elevamento a potenza.

Esempi

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

Risultato

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

La lista fornisce due argomenti posizionali a `compute_rows`; `label` viene passato separatamente per nome. `build_config` raccoglie `theme` in `opts`. Le chiamate senza argomenti mostrano la tupla e il dizionario vuoti, oltre al valore predefinito di `label`.

Lezioni correlate

  • Python · Lezione 18 · Intermedio · Versione: 3

Fonti