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

CKTIS / Python

Reticências na anotação de um tuplo de comprimento variável

`tuple[T, ...]` descreve um tuplo de qualquer comprimento, incluindo o tuplo vazio, cujos elementos têm de ser compatíveis com `T`.

Versão: Python 3.12

Sintaxe

tuple[T, ...]
points: tuple[tuple[float, float], ...]

Em Python 3.12, tuple[T, ...] não requer nenhuma importação. O literal ... representa Ellipsis. A seguir a T, indica que o mesmo tipo se aplica a todas as posições: o tuplo pode ter zero, um ou mais elementos. As reticências não acrescentam um elemento ao tuplo.

Em tuple[tuple[float, float], ...], só o comprimento do tuplo exterior é variável. Cada tuplo interior tem exatamente duas posições anotadas como float (a verificação estática também aceita int nessas posições, sem converter os valores). Em contraste, tuple[T] exige exatamente um elemento e tuple[()] descreve apenas o tuplo vazio.

A anotação serve para a verificação estática de tipos. Durante a execução, o Python não verifica o comprimento dos tuplos nem o tipo dos seus elementos com base na anotação. Se for necessário validar os dados de entrada, essa verificação tem de ser explícita.

Exemplos

def count_points(points: tuple[tuple[float, float], ...]) -> int:
    return len(points)


print(count_points(()))
print(count_points(((1.0, 2.0),)))
print(count_points(((1.0, 2.0), (3.0, 4.0))))

Resultado

0
1
2

O programa apresenta `0`, `1` e `2` em linhas separadas. Em `((1.0, 2.0),)`, a vírgula depois do par faz com que o tuplo exterior tenha um único elemento. `((1.0,),)` não corresponde à anotação porque falta a segunda coordenada do par.

Lições relacionadas

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

Fontes