[docs] [issue16128] hashable documentation error
report at bugs.python.org
Thu Oct 4 13:37:14 CEST 2012
New submission from Max:
Objects which are instances of user-defined classes are hashable by default; they all compare unequal, and their hash value is their id().
Since x == x returns True by default, so "they all compare unequal" isn't quite right.
In addition, both the above paragraph and http://docs.python.org/dev/reference/datamodel.html?highlight=__eq__#object.__hash__ say:
User-defined classes have __eq__() and __hash__() methods by default; with them, all objects compare unequal (except with themselves) and x.__hash__() returns an appropriate value such that x == y implies both that x is y and hash(x) == hash(y).
This is correct, but may leave some confusion with the reader about what happens to a subclass of a built-in class (which doesn't use the default behavior, but instead simply inherits the parent's __hash__ and __eq__).
assignee: docs at python
nosy: docs at python, max
title: hashable documentation error
versions: Python 3.2
Python tracker <report at bugs.python.org>
More information about the docs