CKTIS / Python
O parâmetro `*args`: recolher argumentos posicionais
Na definição de uma função, `*args` recolhe os argumentos posicionais restantes num tuplo. Na chamada `fn(*args)`, o asterisco faz o inverso: passa os elementos do tuplo como argumentos posicionais separados.
Versão: Python 3.12
Sintaxe
def wrapper(*args):
return fn(*args)Em Python 3.12, def wrapper(*args): declara um parâmetro que recolhe todos os argumentos posicionais que não foram associados a parâmetros anteriores. No corpo da função, args é um tuplo local que mantém a ordem desses argumentos. Se não sobrar nenhum, o tuplo é vazio: (). O nome args é uma convenção, não uma palavra reservada: *values funciona da mesma forma.
Os parâmetros comuns escritos depois de *args, como scale no exemplo, só podem ser passados pelo nome. *args não recolhe argumentos passados pelo nome, e args=... não associa um valor a esse tuplo. Um parâmetro **kwargs no fim da lista recolhe os argumentos adicionais passados pelo nome, em vez de receber um valor associado ao seu próprio nome. Sem ele, um argumento inesperado passado pelo nome provoca um TypeError.
Na chamada fn(*args), o asterisco expande um iterável (neste caso, o tuplo) em argumentos posicionais separados. Já fn(args) passa o tuplo inteiro como um só argumento. Uma função intermediária pode, assim, recolher e encaminhar argumentos pela mesma ordem, mas é fn que determina quantos aceita. Se houver demasiados argumentos posicionais, a chamada a fn provoca um TypeError.
Exemplos
def fn(a=0, b=0):
return a + b
def wrapper(*args, scale=1):
print(args)
return scale * fn(*args)
print(wrapper(2, 3, scale=10))
print(wrapper())Resultado
(2, 3) 50 () 0
A primeira chamada apresenta `(2, 3)` e encaminha dois números para `fn`; `scale=10` multiplica a sua soma por 10. A segunda apresenta `()`, pelo que `fn` não recebe argumentos e usa ambos os valores predefinidos.
Lições relacionadas
- Python · Lição 43 · Avançado · Versão: 5