Python · Essencial · Português · Técnico
argumento nomeado
Argumento passado com o nome do parâmetro, como f(largura=10), em vez de pela posição. Deixa a chamada legível e permite ordem livre.
Onde usar
Muito usado em funções com várias opções, como print(sep=...) e open(encoding=...). Em APIs públicas, o review costuma pedir que flags booleanos sejam passados por nome.
Em código
def caixa(largura, altura=1, cor='azul'):
return largura * altura, cor
print(caixa(5, cor='verde'))
print(caixa(altura=2, largura=3))Exemplos
Passe o encoding como argumento nomeado.
Fica mais claro chamar com argumento nomeado do que com um True solto.
Cuidado
Na chamada, argumentos posicionais devem vir antes dos nomeados; um posicional depois de um nomeado gera SyntaxError.
Sinônimos
keyword argument, kwarg
Antônimos
argumento posicional