]> git.ipfire.org Git - thirdparty/Python/cpython.git/commitdiff
gh-111622: Fix doc for items views (#112051)
authorTerry Jan Reedy <tjreedy@udel.edu>
Tue, 14 Nov 2023 07:41:20 +0000 (02:41 -0500)
committerGitHub <noreply@github.com>
Tue, 14 Nov 2023 07:41:20 +0000 (07:41 +0000)
They are set-like even when some values are not hashable,
but work even better when all are.

Doc/library/stdtypes.rst

index 8160740c7a05bd125190b81ec94d55bb71762b5f..f204b287b565eb379e7ff10ced1d9dbab3dab502 100644 (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::