CKTIS / Python
Unioni di tipi: X | Y e X | None
Nelle annotazioni di tipo, l’unione X | Y indica un valore di tipo X oppure Y, mentre l’unione X | None ammette anche None. Le annotazioni descrivono i valori consentiti, ma non impongono automaticamente controlli a runtime.
Versione: Python 3.14; repository image, production runtime not attested
Sintassi
X | Y
X | NoneCon il comportamento standard di |, X | Y crea un’unione di tipi equivalente a typing.Union[X, Y]: un valore può essere di tipo X oppure Y. A runtime, però, una metaclasse personalizzata può ridefinire __or__. Anche se entrambi gli operandi sono tipi, X | Y può allora restituire qualcosa di diverso da un’unione e, in tal caso, non è equivalente a typing.Union[X, Y]. Si possono combinare più tipi, per esempio int | str | None. Qui | combina tipi, non valori booleani. La sintassi è disponibile da Python 3.10; in Python 3.14 gli oggetti unione sono istanze di typing.Union e types.UnionType è un alias di questa classe.
Come unione di tipi, X | None indica un valore di tipo X oppure il valore None ed equivale a typing.Optional[X]. Non significa che un argomento possa essere omesso: solo un valore predefinito, come value: int | None = None, consente di ometterlo nella chiamata. Le annotazioni non controllano né convertono automaticamente gli argomenti a runtime; il codice deve gestire None autonomamente.
L’ordine degli elementi non influisce sull’uguaglianza dell’unione e i duplicati vengono rimossi: int | str == str | int e int | str | int == int | str. Le unioni si possono usare con isinstance() e issubclass(), ma i tipi parametrizzati come list[int] non sono adatti a questi controlli. Il controllo isinstance([1], int | list[int]) genera TypeError.
Quando valuti un’espressione di unione a runtime, non combinare un tipo con un riferimento testuale a una classe: int | "Foo" genera un errore. Se un’annotazione richiede un riferimento del genere, racchiudi tra virgolette l’intera espressione: "int | Foo". Nell’esempio, describe gestisce esplicitamente None e poi converte gli altri valori in testo.
Identificatori di riferimento trattati in questa voce: X | None / X | Y type union.
Esempi
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))Risultato
7 hello missing True
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.