CKTIS / Python
Parâmetros variádicos `*args` e `**kwargs`
Em Python 3.12, `*args` recolhe os argumentos posicionais excedentes num tuplo e `**kwargs` os argumentos nomeados sem correspondência num dicionário. Numa chamada, os mesmos símbolos desempacotam argumentos.
Versão: Python 3.12
Sintaxe
def f(first, *args, flag=False, **kwargs):
...Na definição de uma função, *args recolhe, pela ordem em que foram passados, os argumentos posicionais que não foram associados a parâmetros anteriores e guarda-os num tuplo (tuple). **kwargs recolhe, num novo dicionário (dict), os argumentos nomeados que não correspondem a nenhum parâmetro declarado que os possa receber. Se não houver nada a recolher, obtêm-se, respetivamente, () e {}. Os nomes args e kwargs são convencionais: *items e **opts funcionam da mesma forma.
Um parâmetro como flag depois de *args só pode ser passado pelo nome, por exemplo, com flag=True. Um * isolado também introduz parâmetros deste tipo, mas não recolhe argumentos. Se ambos os parâmetros variádicos estiverem presentes, *args vem antes de **kwargs, e **kwargs fica no fim da lista de parâmetros.
Numa chamada, o sentido é inverso: f(*items) expande um iterável em argumentos posicionais distintos, e f(**opts) expande as entradas de um mapeamento com chaves do tipo str em argumentos nomeados. Passar dois valores para o mesmo parâmetro ou passar um argumento nomeado sem correspondência quando não há **kwargs provoca TypeError. Nestes contextos, * e ** não representam multiplicação nem potenciação.
Exemplos
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())Resultado
('scores', (10, 20))
('rows', ())
{'theme': 'dark'}
{}
A lista fornece dois argumentos posicionais a `compute_rows`; `label` é passado separadamente pelo nome. `build_config` recolhe `theme` em `opts`. As chamadas sem argumentos mostram o tuplo e o dicionário vazios, bem como o valor predefinido de `label`.
Lições relacionadas
- Python · Lição 18 · Intermédio · Versão: 3