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

CKTIS / Python

L’union de types `X | None`

`X | None` décrit une valeur de type `X` ou la valeur `None`. Dans `-> str | None`, l’union décrit la valeur renvoyée par une fonction, pas une valeur par défaut.

Version : Python 3.12

Syntaxe

X | None

En Python 3.12, X | None forme l’union du type X et du type dont None est l’unique valeur. Cette syntaxe existe depuis Python 3.10. Dans str | None, | construit une union de types ; il ne calcule pas un OU bit à bit sur des entiers. Comme annotation de type, X | None est équivalent à typing.Optional[X] et à typing.Union[X, None].

L’annotation de paramètre value: str | None permet de passer None, mais pas d’omettre l’argument : aucune valeur par défaut n’est spécifiée. L’écriture value: str | None = None fournit en plus une valeur par défaut. Python ne vérifie pas lui-même ces annotations à l’exécution.

Dans l’exemple, -> str | None décrit la valeur renvoyée par la fonction auxiliaire parse_args. La méthode argparse.ArgumentParser.parse_args renvoie un argparse.Namespace, tandis que la fonction auxiliaire renvoie seulement son attribut profile. Testez profile is None avant d’utiliser des méthodes de chaîne : '' reste une chaîne et ne signale pas une valeur absente.

Exemples

import argparse


def parse_args(argv: list[str]) -> str | None:
    parser = argparse.ArgumentParser()
    parser.add_argument("--profile", default=None)
    return parser.parse_args(argv).profile


for argv in ([], ["--profile", "dev"], ["--profile="]):
    profile = parse_args(argv)
    if profile is None:
        print("No profile provided")
    else:
        print(f"Profile: {profile!r}")

Résultat

No profile provided
Profile: 'dev'
Profile: ''

Les trois appels montrent l’option `--profile` omise, la valeur `'dev'` et une chaîne vide `''` fournie explicitement.

Leçons associées

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

Sources