Mirror
/
cpython
mirror of https://github.com/python/cpython
4
1
Fork 0
Code Issues Releases Wiki Activity

Updated super() as per http://www.artima.com/weblogs/viewpost.jsp?thread=208549 

but would be worth someone else checking if poss.
This commit is contained in:
Mark Summerfield 2008-02-26 13:27:00 +00:00
parent 836baa53d8
commit 1041f74837
1 changed files with 15 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

24
Doc/library/functions.rst
View File

@ -1025,25 +1025,31 @@ available. They are listed here in alphabetical order.
sequence of strings is by calling ``''.join(sequence)``. sequence of strings is by calling ``''.join(sequence)``.
.. function:: super(type[, object-or-type]) .. function:: super([type[, object-or-type]])
.. XXX need to document PEP "new super" .. XXX updated as per http://www.artima.com/weblogs/viewpost.jsp?thread=208549 but needs checking
Return the superclass of *type*. If the second argument is omitted the super Return the superclass of *type*.
object returned is unbound. If the second argument is an object,
``isinstance(obj, type)`` must be true. If the second argument is a type, Calling :func:`super()` without arguments is equivalent to
``super(this_class, first_arg)``. If called with one
argument the super object returned is unbound. If called with two
arguments and the second argument is an object, ``isinstance(obj,
type)`` must be true. If the second argument is a type,
``issubclass(type2, type)`` must be true. ``issubclass(type2, type)`` must be true.
A typical use for calling a cooperative superclass method is:: A typical use for calling a cooperative superclass method is::
class C(B): class C(B):
def meth(self, arg): def method(self, arg):
super(C, self).meth(arg) super().method(arg) # This does the same thing as: super(C, self).method(arg)
Note that :func:`super` is implemented as part of the binding process for Note that :func:`super` is implemented as part of the binding process for
explicit dotted attribute lookups such as ``super(C, self).__getitem__(name)``. explicit dotted attribute lookups such as ``super().__getitem__(name)``.
Accordingly, :func:`super` is undefined for implicit lookups using statements or Accordingly, :func:`super` is undefined for implicit lookups using statements or
operators such as ``super(C, self)[name]``. operators such as ``super()[name]``. Also, :func:`super` is not
limited to use inside methods: under the hood it searches the stack
frame for the class (``__class__``) and the first argument.
.. function:: tuple([iterable]) .. function:: tuple([iterable])