mirrors/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-09-29 11:45:57 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 11

[3.12] gh-111622: Fix doc for items views (GH-112051) (#112052)

Browse source 
They are set-like even when some values are not hashable,
but work even better when all are.
(cherry picked from commit e31d65e0b7)

Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
This commit is contained in:
Miss Islington (bot) 2023-11-14 10:38:19 +01:00 • committed by GitHub
parent d34650e740
commit 18b88fecc9
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
1 changed files with 8 additions and 5 deletions
Download patch file Download diff file Expand all files Collapse all files

13
Doc/library/stdtypes.rst
View file

@ -4752,14 +4752,17 @@ support membership tests:
.. versionadded:: 3.10 .. versionadded:: 3.10
Keys views are set-like since their entries are unique and :term:`hashable`. If all Keys views are set-like since their entries are unique and :term:`hashable`.
values are hashable, so that ``(key, value)`` pairs are unique and hashable, Items views also have set-like operations since the (key, value) pairs
then the items view is also set-like. (Values views are not treated as set-like 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 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 operations defined for the abstract base class :class:`collections.abc.Set` are
available (for example, ``==``, ``<``, or ``^``). While using set operators, available (for example, ``==``, ``<``, or ``^``). While using set operators,
set-like views accept any iterable as the other operand, unlike sets which only set-like views accept any iterable as the other operand,
accept sets as the input. unlike sets which only accept sets as the input.
An example of dictionary view usage:: An example of dictionary view usage::