set.union()

Метод union() возвращает новое множество, содержащее все уникальные элементы из исходного и всех переданных итерируемых. Эквивалент оператора |, но допускает любые итерируемые в аргументах.

Сигнатура

set.union(*others)

Параметры

*others — одно или несколько итерируемых. Если ничего не передано, возвращается копия исходного множества.

Возвращаемое значение

Новое множество (set) с объединёнными элементами.

Примеры использования

Пример 1. Объединение двух множеств.

a = {1, 2, 3}
b = {3, 4, 5}
print(a.union(b))

{1, 2, 3, 4, 5}

Пример 2. Объединение нескольких источников.

a = {1, 2}
b = {2, 3}
c = {3, 4}
print(a.union(b, c))

{1, 2, 3, 4}

Пример 3. Аргумент-список.

known = {"DHT22", "BMP280"}
new = ["MPU6050", "DHT22", "BH1750"]
print(known.union(new))

{'DHT22', 'BMP280', 'MPU6050', 'BH1750'}

Пример 4. Оператор ``|`` против метода.

a = {1, 2}
b = {3, 4}
print(a | b)
print(a.union(b))

{1, 2, 3, 4}
{1, 2, 3, 4}

Пример 5. Исходные множества не изменяются.

a = {1, 2}
b = {3, 4}
c = a.union(b)
print("a:", a)
print("b:", b)
print("c:", c)

a: {1, 2}
b: {3, 4}
c: {1, 2, 3, 4}

См. также

set.update() — объединение с изменением исходного
set.intersection() — пересечение
set.difference() — разность

Примечание

Лицензия и источники

Техническое описание метода адаптировано из официальной документации Python (https://docs.python.org), доступной под Python Software Foundation License Version 2. Перевод на русский, примеры использования и пояснения — © AlashEd Wiki.