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

CKTIS / Python

Parâmetro posicional variádico `*items`

Na definição de uma função, `*items` reúne os argumentos posicionais restantes num tuplo. Numa chamada, `*values` faz o contrário: passa os elementos de um iterável como argumentos posicionais separados.

Versão: Python 3.12

Sintaxe

def macro_bullet(title, *items, marker="-"):
    ...

Em Python 3.12, *items na definição de uma função declara um parâmetro posicional variádico. Em def macro_bullet(title, *items, marker="-"):, o primeiro argumento posicional é atribuído a title e os restantes formam o tuplo items pela ordem em que foram passados. Se não houver mais argumentos posicionais, items é (). O nome items é livre; args é habitual.

Um parâmetro comum a seguir a *items, como marker, só pode ser passado por nome, por exemplo com marker="+". Passar items=... não atribui um valor ao tuplo items: a chamada gera TypeError, exceto se a função aceitar esse argumento através de **kwargs, que recolhe os argumentos nomeados adicionais num dicionário separado. Um * sem nome marca o início dos parâmetros que só podem ser passados por nome, mas não recolhe argumentos posicionais.

Na chamada macro_bullet("Plan", *values), o asterisco desempacota o iterável values em argumentos posicionais separados. Sem o asterisco, values é passado como um único argumento, mesmo que seja uma lista. Na definição, o asterisco reúne os argumentos; na chamada, desempacota-os.

Exemplos

def macro_bullet(title, *items, marker="-"):
    return title, items, marker

values = [10, 20]
print(macro_bullet("Plan"))
print(macro_bullet("Plan", values))
print(macro_bullet("Plan", 10, 20, marker="+"))
print(macro_bullet("Plan", *values, marker="+"))

Resultado

('Plan', (), '-')
('Plan', ([10, 20],), '-')
('Plan', (10, 20), '+')
('Plan', (10, 20), '+')

A primeira linha mostra um tuplo vazio; a segunda mostra um tuplo com uma única lista. As duas últimas linhas são iguais porque desempacotar `values` passa os mesmos números que escrevê-los separadamente. Ambas as chamadas passam `marker` por nome.

Lições relacionadas

  • Python · Lição 34 · Avançado · Versão: 5

Fontes