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

CKTIS / Python

Unions de types : X | Y et X | None

Dans les annotations de types, l’union X | Y désigne une valeur de type X ou Y, tandis que l’union X | None autorise aussi None. Les annotations décrivent les valeurs permises sans imposer automatiquement de vérifications à l’exécution.

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

Syntaxe

X | Y
X | None

Avec le comportement standard de |, X | Y crée une union de types équivalente à typing.Union[X, Y] : une valeur peut être de type X ou Y. À l’exécution, une métaclasse personnalisée peut toutefois redéfinir __or__. Même si les deux opérandes sont des types, X | Y peut alors renvoyer autre chose qu’une union, auquel cas l’expression n’est pas équivalente à typing.Union[X, Y]. Il est possible de combiner davantage de types, par exemple int | str | None. Ici, | combine des types, et non des valeurs booléennes. Cette syntaxe est disponible à partir de Python 3.10 ; dans Python 3.14, les objets union sont des instances de typing.Union, et types.UnionType est un alias de cette classe.

En tant qu’union de types, X | None désigne une valeur de type X ou la valeur None et équivaut à typing.Optional[X]. Cela ne signifie pas qu’un argument peut être omis : seule une valeur par défaut, comme value: int | None = None, permet de l’omettre lors d’un appel. Les annotations ne vérifient ni ne convertissent automatiquement les arguments à l’exécution ; le code doit gérer lui-même None.

L’ordre des éléments n’a pas d’incidence sur l’égalité des unions, et les doublons sont supprimés : int | str == str | int et int | str | int == int | str. Les unions peuvent être utilisées avec isinstance() et issubclass(), mais les types paramétrés comme list[int] ne conviennent pas à ces vérifications. Le contrôle isinstance([1], int | list[int]) lève une exception TypeError.

Lors de l’évaluation d’une expression d’union à l’exécution, ne combinez pas un type avec une référence à une classe sous forme de chaîne : int | "Foo" échoue. Si une annotation nécessite une telle référence, mettez toute l’expression entre guillemets : "int | Foo". Dans l’exemple, describe traite explicitement None, puis convertit les autres valeurs en texte.

Identifiants de référence couverts par cette entrée : X | None / X | Y type union.

Exemples

def describe(value: int | str | None) -> str:
    if value is None:
        return "missing"
    return str(value)

print(describe(7))
print(describe("hello"))
print(describe(None))
print(isinstance("hello", int | str))

Résultat

7
hello
missing
True

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