Метод sets.issuperset() в Python, вхождение элементов в множество.

Проверяет наличие/вхождение всех элементов последовательности в множество.

Синтаксис:

# Метод
sets.issuperset(other)

# Математический оператор
sets1 >= sets2

Параметры:

other - любой объект поддерживающий итерацию (кортеж, символ или подстрока).
sets, sets1 и sets2 - множество frozenset или set.

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

bool

Описание:

Метод sets.issuperset() позволяет проверить находится ли каждый элемент последовательности other в множестве sets. Метод возвращает True, если множество sets является надмножеством итерируемого объекта other, если нет, то вернет False.

Для проверки на надмножество можно использовать математический оператор >= (больше или равно), но при этом оба проверяемых объекта должны быть множествами frozenset или set. Если это условие не выполнено поднимается исключение TypeError.

Эта операция поддерживается как неизменяемым frozenset, так изменяемым множеством set.

Примеры проверки вхождения всех элементов списка в множество:

>>> set_x = {'march', 'feb', 'may'}
>>> list_y = ['march', 'dec', 'feb', 'may']
# Использование метода
>>> set_x.issuperset(list_y)
# False

# Использование оператора '>=', при этом
# оба объекта должны быть множествами
>>> set_x >= list_y
# Traceback (most recent call last):
#   File "<stdin>", line 1, in <module>
# TypeError: '>=' not supported between instances of 'set' and 'list'

>>> set_x >= set(list_y)
# False

>>> set_x.add('dec')
>>> set_x.issuperset(list_y)
# True

>>> set_x >= frozenset(list_y)
# True

>>> set_x.add('jul')
>>> set_x >= set(list_y)
# True

>>> list_y.append(5)
>>> set_x >= frozenset(list_y)
# False

>>> set_x
# {'dec', 'feb', 'may', 'march', 'jul'}
>>> list_y
# ['march', 'dec', 'feb', 'may', 5]