summaryrefslogtreecommitdiffstats
path: root/Doc
diff options
context:
space:
mode:
authorTerry Jan Reedy <tjreedy@udel.edu>2023-11-14 07:41:20 (GMT)
committerGitHub <noreply@github.com>2023-11-14 07:41:20 (GMT)
commite31d65e0b7bb6d6fee4e8df54e10976b4cfab1de (patch)
tree5d90d473a7755ae4a2b9f678a46e8b8eb8281cec /Doc
parent31ad7e061ebebc484e00ed3ad5ff61061341c35e (diff)
downloadcpython-e31d65e0b7bb6d6fee4e8df54e10976b4cfab1de.zip
cpython-e31d65e0b7bb6d6fee4e8df54e10976b4cfab1de.tar.gz
cpython-e31d65e0b7bb6d6fee4e8df54e10976b4cfab1de.tar.bz2
gh-111622: Fix doc for items views (#112051)
They are set-like even when some values are not hashable, but work even better when all are.
Diffstat (limited to 'Doc')
-rw-r--r--Doc/library/stdtypes.rst13
1 files changed, 8 insertions, 5 deletions
diff --git a/Doc/library/stdtypes.rst b/Doc/library/stdtypes.rst
index 8160740..f204b28 100644
--- a/Doc/library/stdtypes.rst
+++ b/Doc/library/stdtypes.rst
@@ -4755,14 +4755,17 @@ support membership tests:
.. versionadded:: 3.10
-Keys views are set-like since their entries are unique and :term:`hashable`. If all
-values are hashable, so that ``(key, value)`` pairs are unique and hashable,
-then the items view is also set-like. (Values views are not treated as set-like
+Keys views are set-like since their entries are unique and :term:`hashable`.
+Items views also have set-like operations since the (key, value) pairs
+are unique and the keys are hashable.
+If all values in an items view are hashable as well,
+then the items view can interoperate with other sets.
+(Values views are not treated as set-like
since the entries are generally not unique.) For set-like views, all of the
operations defined for the abstract base class :class:`collections.abc.Set` are
available (for example, ``==``, ``<``, or ``^``). While using set operators,
-set-like views accept any iterable as the other operand, unlike sets which only
-accept sets as the input.
+set-like views accept any iterable as the other operand,
+unlike sets which only accept sets as the input.
An example of dictionary view usage::