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