Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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

Fontes