База знанияИзпитен център
BGБългарски
Избери език13

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

Показаният код и посоченият резултат са проверени в изолирана среда по метода, документиран в доказателството за проверка на точно тази версия.

Източници