CKTIS / Python
Puntos suspensivos en la anotación de una tupla de longitud variable
`tuple[T, ...]` describe una tupla de cualquier longitud, incluida la tupla vacía, cuyos elementos deben ser compatibles con `T`.
Versión: Python 3.12
Sintaxis
tuple[T, ...]
points: tuple[tuple[float, float], ...]En Python 3.12, tuple[T, ...] no requiere ninguna importación. El literal ... representa Ellipsis. Después de T, indica que el mismo tipo se aplica a todas las posiciones: la tupla puede tener cero, uno o más elementos. No añade ningún elemento a la tupla.
En tuple[tuple[float, float], ...], solo varía la longitud de la tupla exterior. Cada tupla interior tiene exactamente dos posiciones anotadas como float (la comprobación estática también admite int en esas posiciones, sin convertir los valores). En cambio, tuple[T] exige exactamente un elemento y tuple[()] describe solo la tupla vacía.
La anotación sirve para la comprobación estática de tipos. Durante la ejecución, Python no comprueba las longitudes de las tuplas ni los tipos de sus elementos a partir de la anotación. Si necesitas validar los datos de entrada, hazlo explícitamente.
Ejemplos
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
El programa imprime `0`, `1` y `2` en líneas separadas. En `((1.0, 2.0),)`, la coma que sigue al par hace que la tupla exterior tenga un solo elemento. `((1.0,),)` no cumple la anotación porque al par le falta la segunda coordenada.
Lecciones relacionadas
- Python · Lección 13 · Avanzado · Versión: 5