bpo-37585: Add clarification regarding comparing dict.values() (GH-14954)

This commit is contained in:
Kyle Stanley 2019-09-11 06:01:41 -04:00 committed by Brett Cannon
parent 4576b5431b
commit 6472ece5a0

View file

@ -4357,6 +4357,14 @@ pairs within braces, for example: ``{'jack': 4098, 'sjoerd': 4127}`` or ``{4098:
Return a new view of the dictionary's values. See the
:ref:`documentation of view objects <dict-views>`.
An equality comparison between one ``dict.values()`` view and another
will always return ``False``. This also applies when comparing
``dict.values()`` to itself::
>>> d = {'a': 1}
>>> d.values() == d.values()
False
Dictionaries compare equal if and only if they have the same ``(key,
value)`` pairs. Order comparisons ('<', '<=', '>=', '>') raise
:exc:`TypeError`.