mirror of
https://github.com/python/cpython.git
synced 2025-11-01 10:45:30 +00:00
bpo-41910: specify the default implementations of object.__eq__ and object.__ne__ (GH-22874)
See Objects/typeobject.c:object_richcompare() for the implementation of this in CPython. Automerge-Triggered-By: GH:brettcannon
This commit is contained in:
parent
b451b0e9a7
commit
3c69f0c933
2 changed files with 9 additions and 6 deletions
|
|
@ -1395,12 +1395,14 @@ Basic customization
|
|||
context (e.g., in the condition of an ``if`` statement), Python will call
|
||||
:func:`bool` on the value to determine if the result is true or false.
|
||||
|
||||
By default, :meth:`__ne__` delegates to :meth:`__eq__` and
|
||||
inverts the result unless it is ``NotImplemented``. There are no other
|
||||
implied relationships among the comparison operators, for example,
|
||||
the truth of ``(x<y or x==y)`` does not imply ``x<=y``.
|
||||
To automatically generate ordering operations from a single root operation,
|
||||
see :func:`functools.total_ordering`.
|
||||
By default, ``object`` implements :meth:`__eq__` by using ``is``, returning
|
||||
``NotImplemented`` in the case of a false comparison:
|
||||
``True if x is y else NotImplemented``. For :meth:`__ne__`, by default it
|
||||
delegates to :meth:`__eq__` and inverts the result unless it is
|
||||
``NotImplemented``. There are no other implied relationships among the
|
||||
comparison operators or default implementations; for example, the truth of
|
||||
``(x<y or x==y)`` does not imply ``x<=y``. To automatically generate ordering
|
||||
operations from a single root operation, see :func:`functools.total_ordering`.
|
||||
|
||||
See the paragraph on :meth:`__hash__` for
|
||||
some important notes on creating :term:`hashable` objects which support
|
||||
|
|
|
|||
|
|
@ -0,0 +1 @@
|
|||
Document the default implementation of `object.__eq__`.
|
||||
Loading…
Add table
Add a link
Reference in a new issue