Mirror
/
cpython
mirror of https://github.com/python/cpython
4
1
Fork 0
Code Issues Releases Wiki Activity

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.
This commit is contained in:
Terry Jan Reedy 2023-11-14 02:41:20 -05:00 committed by GitHub
parent 31ad7e061e
commit e31d65e0b7
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 8 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

13
Doc/library/stdtypes.rst
View File

@ -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::