CKTIS / Python
Typové sjednocení: X | Y a X | None
V typových anotacích označuje sjednocení X | Y hodnotu typu X nebo Y, zatímco sjednocení X | None připouští také None. Anotace popisují povolené hodnoty, ale automaticky nevynucují kontroly za běhu.
Verze: Python 3.14; repository image, production runtime not attested
Syntaxe
X | Y
X | NonePři standardním chování operátoru | vytváří X | Y typové sjednocení rovnocenné zápisu typing.Union[X, Y]: hodnota může být typu X nebo Y. Uživatelsky definovaná metatřída však může za běhu předefinovat metodu __or__. I když jsou oba operandy typy, výraz X | Y pak může vrátit něco jiného než sjednocení a v takovém případě není rovnocenný zápisu typing.Union[X, Y]. Lze kombinovat i více typů, například int | str | None. Zde | spojuje typy, nikoli logické hodnoty. Tato syntaxe je dostupná od Pythonu 3.10; v Pythonu 3.14 jsou objekty sjednocení instancemi typing.Union a types.UnionType je alias této třídy.
Jako typové sjednocení označuje X | None hodnotu typu X nebo hodnotu None a odpovídá zápisu typing.Optional[X]. Neznamená to, že lze argument vynechat: vynechání při volání umožňuje až výchozí hodnota, například value: int | None = None. Anotace za běhu argumenty automaticky nekontrolují ani nepřevádějí; kód musí None zpracovat sám.
Pořadí členů nemá vliv na rovnost sjednocení a duplicity se odstraňují: int | str == str | int a int | str | int == int | str. Sjednocení lze použít s isinstance() a issubclass(), parametrizované typy jako list[int] se však pro tyto kontroly nehodí. Kontrola isinstance([1], int | list[int]) vyvolá TypeError.
Při vyhodnocování výrazu sjednocení za běhu nekombinujte typ s textovým odkazem na třídu: int | "Foo" selže. Pokud anotace takový odkaz potřebuje, uzavřete do uvozovek celý výraz: "int | Foo". V příkladu funkce describe výslovně zpracuje None a poté převede ostatní hodnoty na text.
Referenční identifikátory zahrnuté v tomto hesle: X | None / X | Y type union.
Pří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ýsledek
7 hello missing True
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.