Сообщить об ошибке.

Тип аннотации Union модуля typing в Python.

Типизация объединений Union.

Может использоваться как тип в аннотациях с помощью синтаксиса [].

Синтаксис:

from typing import Union

Union[X, Y]

Параметры:

  • X и Y - тип данных.

Описание:

Тип аннотации Union[] модуля typing представляет собой тип объединения typing.Union[x, y], который означает либо X, либо Y.

Чтобы определить аннотацию объединения, используйте, например, Union[int, str].

Описание деталей использования:

  • Аргументы должны быть типами и должен быть хотя бы один аргумент.

  • Объединения сглаживаются, например:

    Union[Union[int, str], float] == Union[int, str, float]
    
  • Объединения с одним аргументом исчезают, например:

    # Конструктор фактически возвращает `int`
    Union[int] == int
    
  • Избыточные аргументы пропускаются, например:

    Union[int, str, int] == Union[int, str]
    
  • При сравнении объединений порядок аргументов игнорируется, например:

    Union[int, str] == Union[str, int]
    
  • Нельзя создать подкласс объединения Union или создать его экземпляр.

  • Нельзя писать Union[X][Y].

  • Можно использовать Optional[X] как сокращение для Union[X, None].

Изменено в Python 3.7: не удаляет явные подклассы из объединений во время выполнения.