Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / Python

Typové zjednotenia: X | Y a X | None

V typových anotáciách označuje zjednotenie X | Y hodnotu typu X alebo Y, zatiaľ čo zjednotenie X | None pripúšťa aj None. Anotácie opisujú povolené hodnoty, ale automaticky nevynucujú kontroly počas behu.

Verzia: Python 3.14; repository image, production runtime not attested

Syntax

X | Y
X | None

Pri štandardnom správaní operátora | vytvára X | Y typové zjednotenie rovnocenné zápisu typing.Union[X, Y]: hodnota môže byť typu X alebo Y. Používateľsky definovaná metatrieda však môže počas behu predefinovať metódu __or__. Aj keď sú oba operandy typy, výraz X | Y potom môže vrátiť niečo iné než zjednotenie a v takom prípade nie je rovnocenný zápisu typing.Union[X, Y]. Možno kombinovať aj viac typov, napríklad int | str | None. Tu | spája typy, nie boolovské hodnoty. Táto syntax je dostupná od Pythonu 3.10; v Pythone 3.14 sú objekty zjednotenia inštanciami typing.Union a types.UnionType je alias tejto triedy.

Ako typové zjednotenie označuje X | None hodnotu typu X alebo hodnotu None a zodpovedá zápisu typing.Optional[X]. Neznamená to, že argument možno vynechať: vynechanie pri volaní umožňuje až predvolená hodnota, napríklad value: int | None = None. Anotácie počas behu argumenty automaticky nekontrolujú ani nekonvertujú; kód musí None spracovať sám.

Poradie členov nemá vplyv na rovnosť zjednotenia a duplicity sa odstraňujú: int | str == str | int a int | str | int == int | str. Zjednotenia možno použiť s isinstance() a issubclass(), parametrizované typy ako list[int] sa však na takéto kontroly nehodia. Kontrola isinstance([1], int | list[int]) vyvolá TypeError.

Pri vyhodnocovaní výrazu zjednotenia počas behu nekombinujte typ s textovým odkazom na triedu: int | "Foo" zlyhá. Ak anotácia takýto odkaz potrebuje, uzavrite do úvodzoviek celý výraz: "int | Foo". V príklade funkcia describe výslovne spracuje None a potom prevedie ostatné hodnoty na text.

Referenčné identifikátory zahrnuté v tomto hesle: X | None / X | Y type union.

Príklady

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

Výsledok

7
hello
missing
True

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje