Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Python

Puntini di sospensione nell’annotazione di una tupla di lunghezza variabile

`tuple[T, ...]` descrive una tupla di qualsiasi lunghezza, anche vuota, i cui elementi devono essere tutti compatibili con `T`.

Versione: Python 3.12

Sintassi

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

In Python 3.12, tuple[T, ...] non richiede alcuna importazione. Il letterale ... rappresenta Ellipsis. Dopo T, indica che lo stesso tipo vale per ogni posizione: la tupla può contenere zero, uno o più elementi. I puntini non aggiungono un elemento alla tupla.

In tuple[tuple[float, float], ...], solo la lunghezza della tupla esterna è variabile. Ogni tupla interna ha esattamente due posizioni annotate come float (il controllo statico accetta anche int in quelle posizioni, senza convertire i valori). Invece, tuple[T] richiede esattamente un elemento e tuple[()] indica soltanto la tupla vuota.

L’annotazione serve al controllo statico dei tipi. Durante l’esecuzione, Python non usa l’annotazione per verificare la lunghezza delle tuple o il tipo dei loro elementi. Se devi convalidare i dati in ingresso, fallo esplicitamente.

Esempi

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))))

Risultato

0
1
2

Il programma stampa `0`, `1` e `2` su righe separate. In `((1.0, 2.0),)`, la virgola dopo la coppia rende la tupla esterna una tupla con un solo elemento. `((1.0,),)` non rispetta l’annotazione perché alla coppia manca la seconda coordinata.

Lezioni correlate

  • Python · Lezione 13 · Avanzato · Versione: 5

Fonti