diff options
author | Terry Jan Reedy <tjreedy@udel.edu> | 2023-11-14 07:41:20 (GMT) |
---|---|---|
committer | GitHub <noreply@github.com> | 2023-11-14 07:41:20 (GMT) |
commit | e31d65e0b7bb6d6fee4e8df54e10976b4cfab1de (patch) | |
tree | 5d90d473a7755ae4a2b9f678a46e8b8eb8281cec /Doc | |
parent | 31ad7e061ebebc484e00ed3ad5ff61061341c35e (diff) | |
download | cpython-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.rst | 13 |
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:: |