__hash__ 方法和文档。可能的错误？

Question

阅读文档

object.__hash__(self)

由内置函数 hash() 调用，用于对散列集合成员（包括 set、frozenset 和 dict）的操作。 [...]

和....

Python 的所有不可变内置对象都是可散列的，而没有可变容器（例如列表或字典）是可散列的。

从控制台：

>>> a = {'name': 'abcdef'}
>>> hash(a)
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
TypeError: unhashable type: 'dict'

由此我明白 dict 对象是不可散列的，那么为什么文档说我可以在 dict 对象上调用散列函数？

Answer 1

由内置函数 hash() 调用，用于对散列集合的 成员 进行操作，包括 set、frozenset 和 dict。 [...]

__hash__ 在集合成员（或键）上调用，而不是在集合本身上。

Answer 2

您误读了文档。

object.__hash__[c]由内置函数 hash() 调用，用于对散列集合成员的操作，包括 set、frozenset 和 dict。

__hash__ 是 不 在 dict 上调用的。它被dict 的成员调用。

演示：

>>> class Hashable(object):
...     def __hash__(self):
...         print '__hash__ was called'
...         return super(Hashable, self).__hash__()
... 
>>> {Hashable(): None}
__hash__ was called
{<__main__.Hashable object at 0x10bce7750>: None}

因为Hashable() 实例被用作键，所以在创建字典时会调用它的__hash__ 方法。