Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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 | None

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

Viri