mirrors/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-09-26 10:19:53 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 8

SF bug #663701: sets module review

Browse source 
Renamed hook methods to use the double underscore convention.
This commit is contained in:
Raymond Hettinger 2003-02-14 03:42:11 +00:00
parent e544f6f682
commit 2835e37be5
2 changed files with 11 additions and 11 deletions
Download patch file Download diff file Expand all files Collapse all files

8
Doc/lib/libsets.tex
View file

@ -203,23 +203,23 @@ before being added as a set element.
The mechanism is to always add a hashable element, or if it is not
hashable, the element is checked to see if it has an
\method{_as_immutable()} method which returns an immutable equivalent.
\method{__as_immutable__()} method which returns an immutable equivalent.
Since \class{Set} objects have a \method{_as_immutable()} method
Since \class{Set} objects have a \method{__as_immutable__()} method
returning an instance of \class{ImmutableSet}, it is possible to
construct sets of sets.
A similar mechanism is needed by the \method{__contains__()} and
\method{remove()} methods which need to hash an element to check
for membership in a set. Those methods check an element for hashability
and, if not, check for a \method{_as_temporarily_immutable()} method
and, if not, check for a \method{__as_temporarily_immutable__()} method
which returns the element wrapped by a class that provides temporary
methods for \method{__hash__()}, \method{__eq__()}, and \method{__ne__()}.
The alternate mechanism spares the need to build a separate copy of
the original mutable object.
\class{Set} objects implement the \method{_as_temporarily_immutable()}
\class{Set} objects implement the \method{__as_temporarily_immutable__()}
method which returns the \class{Set} object wrapped by a new class
\class{_TemporarilyImmutableSet}.