mirrors/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-08-04 00:48:58 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 8

gh-96408: Document difference between set-like view and sets. (GH-96439)

Browse source
This commit is contained in:
Piotr Kaznowski 2022-08-31 23:23:52 +02:00 • committed by GitHub
parent 29f1b0bb1f
commit 615537e62f
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
1 changed files with 5 additions and 1 deletions
Download patch file Download diff file Expand all files Collapse all files

6
Doc/library/stdtypes.rst
View file

@ -4694,7 +4694,9 @@ 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
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 ``^``).
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.
An example of dictionary view usage::
@ -4726,6 +4728,8 @@ An example of dictionary view usage::
{'bacon'}
>>> keys ^ {'sausage', 'juice'}
{'juice', 'sausage', 'bacon', 'spam'}
>>> keys | ['juice', 'juice', 'juice']
{'juice', 'sausage', 'bacon', 'spam', 'eggs'}
>>> # get back a read-only proxy for the original dictionary
>>> values.mapping