Позволяет реализовать проверку на равенство для экземпляров пользовательских типов.
object.__eq__(self, other)
self -- Ссылка на экземпляр.
other -- Объект с которым следует произвести сравнение (справа от оператора сравнения).

Метод для реализации «богатого сравнения». eq от англ. «equal» — равно.

Метод может возбудить исключение NotImplementedError, если сравнение для указанной пары аргументов не реализовано.

В соответствии с договорённостью в случае успешного сравнения возвращает True, либо False. Однако, может возвращать и любое другое значение, таким образом, если результат сравнения будет использован в контексте Булева типа (например в условии if), Питон произведёт вызов bool() для интерпретации данного значения.

    class Moon:

def __eq__(self, other):
print('moon eq')
return self is other


class Earth:

def __eq__(self, other):
print('earth eq')
return self is other


my_moon = Moon()
my_earth = Earth()

is_eq = (my_moon == my_earth) # moon eq
is_eq # False
is_eq = (my_earth == my_moon) # earth eq
is_eq # False

is_eq = (my_earth == my_earth) # earth eq
is_eq # True

+py3.4 По умолчанию object.__ne__() делегирует управление данному методу, инвертируя результат, если только не было поднято NotImplemented.

-py3.4 Между различными операторами сравнения нет подразумеваемых взаимосвязей. Так истинность (x< y or x==y) не подразумевает x<=y. Поэтому, при определении __eq__() также необходимо определить и object.__ne__() для того чтобы операторы вели себя ожидаемым образом.

Не существует «перевёрнутых» методов, которые могли бы использоваться автоматически, если левый аргумент не поддерживает вызванную операцию, а правый поддерживает. Вместо этого обычно считают зеркальными __eq__() и __ne__() . +py3.4 Если операнды имеют различные типы и тип правого операнда является прямым или косвенным наследником типа левого операнда о метод-отражение правого операнда имеет приоритет, в иных случаях приоритет остаётся у метода левого операнда. При этом виртуальное наследование не учитывается.

На заметку
Для автоматического генерирования операций упорядочивания по единой базовой операции можно использовать functools.total_ordering().

Для получения дополнительной важной информации об использовании «богатого сравнения» при создании объектов, поддерживающих хеширование, которые могут использоваться в качестве ключей в словарях смотрите object.__hash__().

См. также другие методы для реализации «богатого сравнения»:


Синонимы поиска: равно, равенство, ==

Нет обсуждений для отображения.
Если у вас есть, что сказать, можете представиться и исправить ситуацию.