CKTIS / Python
Обединения на типове: X | Y и X | None
В анотациите на типове обединението X | Y означава стойност от тип X или Y, а обединението X | None допуска и None. Анотациите описват допустимите стойности, но не налагат автоматично проверки по време на изпълнение.
Версия: Python 3.14; repository image, production runtime not attested
Синтаксис
X | Y
X | NoneПри стандартното поведение на оператора | изразът X | Y създава обединение на типове, еквивалентно на typing.Union[X, Y]: стойността може да е от тип X или Y. По време на изпълнение обаче потребителски метаклас може да предефинира метода __or__. Дори и двата операнда да са типове, тогава X | Y може да върне нещо различно от обединение и в такъв случай не е еквивалентен на typing.Union[X, Y]. Могат да се комбинират повече типове, например int | str | None. Тук | свързва типове, а не булеви стойности. Синтаксисът е наличен от Python 3.10; в Python 3.14 обектите на обединение са екземпляри на typing.Union, а types.UnionType е псевдоним на този клас.
Като обединение на типове X | None означава стойност от тип X или стойността None и е еквивалентно на typing.Optional[X]. Това не означава, че аргументът може да бъде пропуснат: само стойност по подразбиране, например value: int | None = None, позволява пропускането му при извикване. Анотациите не проверяват и не преобразуват автоматично аргументите по време на изпълнение; кодът трябва сам да обработи None.
Редът на елементите не влияе на равенството на обединението, а повторенията се премахват: int | str == str | int и int | str | int == int | str. Обединенията могат да се използват с isinstance() и issubclass(), но параметризирани типове като list[int] не са подходящи за тези проверки. Проверката isinstance([1], int | list[int]) предизвиква TypeError.
Когато изчислявате израз за обединение по време на изпълнение, не комбинирайте тип с текстова препратка към клас: int | "Foo" води до грешка. Ако анотацията изисква такава препратка, поставете целия израз в кавички: "int | Foo". В примера describe обработва изрично None, след което преобразува останалите стойности в текст.
Референтни идентификатори, обхванати в тази статия: X | None / X | Y type union.
Примери
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))Резултат
7 hello missing True
Показаният код и посоченият резултат са проверени в изолирана среда по метода, документиран в доказателството за проверка на точно тази версия.