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

CKTIS / Python

typing.List — annotation de type de liste historique

typing.List[T] décrit une liste d’éléments de type T. Ce type reste disponible en Python 3.14, mais il est préférable d’utiliser list[T] dans le nouveau code.

Version : Python 3.14; repository image, production runtime not attested

Syntaxe

from typing import List

values: List[int] = [1, 2, 3]
# Python 3.9+: values: list[int] = [1, 2, 3]

typing.List est un alias obsolète de list, utilisé dans les annotations de type. Après from typing import List, List[int] désigne une liste d’éléments de type int.

Depuis Python 3.9, préférez list[int] : aucun import n’est nécessaire. typing.List est obsolète depuis cette version, mais reste disponible en Python 3.14 sans avertissement de l’interpréteur.

Une annotation ne vérifie pas les éléments à l’exécution et ne les convertit pas ; elle sert à l’analyse statique. Créez des listes avec [] ou list(), et non avec typing.List.

Si un argument nécessite uniquement l’itération ou l’accès à une séquence, envisagez collections.abc.Iterable[T] ou collections.abc.Sequence[T] plutôt qu’une liste concrète.

Exemples

from typing import List


def doubled(values: List[int]) -> list[int]:
    return [value * 2 for value in values]


numbers: List[int] = [1, 2, 3]
print(doubled(numbers))

Résultat

[2, 4, 6]

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources