Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Python

L’unione di tipi `X | None`

`X | None` descrive un valore di tipo `X` oppure `None`. In `-> str | None` indica il risultato di una funzione, non un valore predefinito.

Versione: Python 3.12

Sintassi

X | None

In Python 3.12, X | None unisce il tipo X al tipo che ha come unico valore None. Questa sintassi è disponibile da Python 3.10. In str | None, | costruisce un’unione di tipi: non calcola un OR bit a bit su interi. Come annotazione di tipo, X | None equivale a typing.Optional[X] e a typing.Union[X, None].

L’annotazione del parametro value: str | None permette di passare None, ma non di omettere l’argomento: non è indicato alcun valore predefinito. Scrivendo value: str | None = None si imposta anche un valore predefinito. Python non verifica automaticamente queste annotazioni durante l’esecuzione.

Nell’esempio, -> str | None descrive il risultato della funzione ausiliaria parse_args. Il metodo argparse.ArgumentParser.parse_args restituisce un argparse.Namespace, mentre la funzione ausiliaria restituisce solo il suo attributo profile. Controlla profile is None prima di usare i metodi delle stringhe: '' è comunque una stringa e non indica l’assenza di un valore.

Esempi

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

Risultato

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

Le tre chiamate mostrano l’opzione `--profile` omessa, il valore `'dev'` e una stringa vuota `''` passata esplicitamente.

Lezioni correlate

  • Python · Lezione 34 · Avanzato · Versione: 5

Fonti