set.add()

Метод add() добавляет указанный элемент во множество. Если такой элемент уже присутствует, множество остаётся без изменений — дубликаты во множествах не хранятся. Метод изменяет исходное множество и ничего не возвращает.

Сигнатура

set.add(elem)

Параметры

elem — добавляемый элемент. Должен быть хешируемым (числа, строки, кортежи), списки и словари не подходят.

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

None. Метод модифицирует множество на месте.

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

Пример 1. Добавление новых элементов.

sensors = {"DHT22", "BMP280"}
sensors.add("MPU6050")
print(sensors)

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

Пример 2. Попытка добавить дубликат.

pins = {2, 3, 4}
pins.add(3)
print(pins)

{2, 3, 4}

Пример 3. Сбор уникальных слов из текста.

words = set()
for word in "arduino esp32 arduino raspberry esp32".split():
    words.add(word)
print(words)

{'arduino', 'esp32', 'raspberry'}

Пример 4. Кортежи как элементы.

coords = set()
coords.add((0, 0))
coords.add((1, 2))
coords.add((0, 0))
print(coords)

{(0, 0), (1, 2)}

Пример 5. Ошибка при добавлении списка.

s = set()
s.add([1, 2])

TypeError: unhashable type: 'list'

См. также

set.update() — добавление нескольких элементов сразу
set.remove() — удаление элемента
set.discard() — удаление без ошибки

Примечание

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

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