Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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

Př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.

Zdroje