#7771: reference to documentation of dictview methods and operations.
This commit is contained in:
parent
1f7fffb308
commit
f74cf77c8d
|
@ -2208,34 +2208,11 @@ support membership tests:
|
|||
|
||||
|
||||
Keys views are set-like since their entries are unique and 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
|
||||
since the entries are generally not unique.) Then these set operations are
|
||||
available ("other" refers either to another view or a set):
|
||||
|
||||
.. describe:: dictview & other
|
||||
|
||||
Return the intersection of the dictview and the other object as a new set.
|
||||
|
||||
.. describe:: dictview | other
|
||||
|
||||
Return the union of the dictview and the other object as a new set.
|
||||
|
||||
.. describe:: dictview - other
|
||||
|
||||
Return the difference between the dictview and the other object (all elements
|
||||
in *dictview* that aren't in *other*) as a new set.
|
||||
|
||||
.. describe:: dictview ^ other
|
||||
|
||||
Return the symmetric difference (all elements either in *dictview* or
|
||||
*other*, but not in both) of the dictview and the other object as a new set.
|
||||
|
||||
.. method:: dictview.isdisjoint(other)
|
||||
|
||||
Return True if the view has no elements in common with *other*. Sets are
|
||||
disjoint if and only if their intersection is the empty set.
|
||||
|
||||
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.Set` are
|
||||
available (for example, ``==``, ``<``, or ``^``).
|
||||
|
||||
An example of dictionary view usage::
|
||||
|
||||
|
@ -2265,6 +2242,8 @@ An example of dictionary view usage::
|
|||
>>> # set operations
|
||||
>>> keys & {'eggs', 'bacon', 'salad'}
|
||||
{'bacon'}
|
||||
>>> keys ^ {'sausage', 'juice'}
|
||||
{'juice', 'eggs', 'bacon', 'spam'}
|
||||
|
||||
|
||||
.. _typememoryview:
|
||||
|
|
Loading…
Reference in New Issue