object.__eq__

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

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

В соответствии с договорённостью в случае успешного сравнения возвращает 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 Если операнды имеют различные типы и тип правого операнда является прямым или косвенным наследником типа левого операнда о метод-отражение правого операнда имеет приоритет, в иных случаях приоритет остаётся у метода левого операнда. При этом виртуальное наследование не учитывается.


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