CKTIS / Python
Parâmetros variádicos: *args e **kwargs
O parâmetro *args reúne os argumentos posicionais adicionais num tuplo, enquanto **kwargs reúne os argumentos nomeados adicionais num dicionário. Assim, uma função pode aceitar um número variável de argumentos.
Versão: Python 3.14; repository image, production runtime not attested
Sintaxe
def function_name(*args, **kwargs):
...Na definição de uma função, *args reúne num tuplo os argumentos posicionais que não foram atribuídos aos parâmetros anteriores. **kwargs reúne num dicionário os argumentos nomeados que não foram associados. Se não existirem argumentos deste tipo, recebem () e {}, respetivamente. Os nomes args e kwargs são convencionais; o comportamento é determinado por * e **.
Podes usar um destes parâmetros ou ambos. **kwargs tem de ser o último parâmetro. Os parâmetros normais depois de *args, como active no exemplo, só aceitam argumentos nomeados. Se forneceres um valor, tens de indicar o nome do parâmetro. Se o parâmetro tiver um valor predefinido, podes omiti-lo na chamada. Um * isolado também introduz parâmetros que só aceitam argumentos nomeados, mas não reúne argumentos posicionais.
No exemplo, label recebe o primeiro argumento, args reúne 10 e 20, active recebe True e kwargs contém apenas color. Na segunda chamada, args e kwargs estão vazios e, como active é omitido, é usado o seu valor predefinido, False. Não confundas a recolha numa definição com o desempacotamento de *values e **options numa chamada: nesse caso, os operadores passam os elementos como argumentos separados.
Identificadores de referência abrangidos por esta entrada: *args / **kwargs parameters.
Exemplos
def collect(label, *args, active=False, **kwargs):
print(label, args, active, kwargs)
collect("A", 10, 20, active=True, color="blue")
collect("B")Resultado
A (10, 20) True {'color': 'blue'}
B () False {}O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.