Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Python

Points de suspension dans l’annotation d’un tuple de longueur variable

`tuple[T, ...]` décrit un tuple de longueur quelconque, éventuellement vide, dont chaque élément doit être compatible avec le type `T`.

Version : Python 3.12

Syntaxe

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

En Python 3.12, tuple[T, ...] ne nécessite aucun import. Le littéral ... représente Ellipsis. Placé après T, il indique que le même type s’applique à chaque position : le tuple peut contenir zéro, un ou plusieurs éléments. Il n’ajoute pas d’élément au tuple.

Dans tuple[tuple[float, float], ...], seule la longueur du tuple extérieur est variable. Chaque tuple intérieur possède exactement deux positions annotées float (le typage statique y accepte aussi int, sans convertir les valeurs). En revanche, tuple[T] exige exactement un élément et tuple[()] désigne uniquement le tuple vide.

L’annotation sert à la vérification statique des types. À l’exécution, Python ne vérifie ni la longueur des tuples ni le type de leurs éléments à partir de l’annotation. Pour valider des données d’entrée, il faut effectuer une vérification explicite.

Exemples

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

Résultat

0
1
2

Le programme affiche `0`, `1` et `2` sur des lignes distinctes. Dans `((1.0, 2.0),)`, la virgule après la paire fait du tuple extérieur un tuple à un seul élément. `((1.0,),)` ne respecte pas l’annotation, car il manque la deuxième coordonnée de la paire.

Leçons associées

  • Python · Leçon 13 · Avancé · Version : 5

Sources