CKTIS / Python
Unije tipov: X | Y in X | None
V tipnih anotacijah unija X | Y označuje vrednost tipa X ali Y, unija X | None pa dopušča tudi None. Anotacije opisujejo dovoljene vrednosti, vendar med izvajanjem ne zahtevajo samodejnega preverjanja.
Različica: Python 3.14; repository image, production runtime not attested
Sintaksa
X | Y
X | NonePri standardnem delovanju operatorja | izraz X | Y ustvari unijo tipov, enakovredno zapisu typing.Union[X, Y]: vrednost je lahko tipa X ali Y. Med izvajanjem pa lahko metarazred po meri prepiše metodo __or__. Tudi če sta oba operanda tipa, lahko X | Y tedaj vrne kaj drugega kot unijo in v tem primeru ni enakovreden zapisu typing.Union[X, Y]. Združimo lahko več tipov, na primer int | str | None. Tukaj | povezuje tipe, ne logičnih vrednosti. Ta sintaksa je na voljo od Pythona 3.10; v Pythonu 3.14 so objekti unije primerki typing.Union, types.UnionType pa je vzdevek tega razreda.
Kot unija tipov izraz X | None označuje vrednost tipa X ali vrednost None in je enakovreden zapisu typing.Optional[X]. To ne pomeni, da lahko argument izpustimo: izpustitev pri klicu omogoča šele privzeta vrednost, na primer value: int | None = None. Anotacije med izvajanjem argumentov ne preverjajo ali pretvarjajo samodejno; koda mora None obravnavati sama.
Vrstni red članov ne vpliva na enakost unije, podvojeni člani pa se odstranijo: int | str == str | int in int | str | int == int | str. Unije lahko uporabimo z isinstance() in issubclass(), parametrizirani tipi, kot je list[int], pa za taka preverjanja niso primerni. Preverjanje isinstance([1], int | list[int]) sproži TypeError.
Pri vrednotenju izraza unije med izvajanjem ne združujte tipa z besedilnim sklicem na razred: int | "Foo" ne deluje. Če anotacija potrebuje tak sklic, postavite v narekovaje celoten izraz: "int | Foo". V primeru describe izrecno obdela None, nato pa preostale vrednosti pretvori v besedilo.
Referenčni identifikatorji, zajeti v tem geslu: X | None / X | Y type union.
Primeri
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))Rezultat
7 hello missing True
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju prav te različice.