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 | NoneAvec 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.