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

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.

Fontes