diff options
author | Neal Norwitz <nnorwitz@gmail.com> | 2002-12-17 01:02:57 (GMT) |
---|---|---|
committer | Neal Norwitz <nnorwitz@gmail.com> | 2002-12-17 01:02:57 (GMT) |
commit | e9ce25e512d455ae263600b67daef665a4ad13b5 (patch) | |
tree | fd566f84e9a03a071fe9ebe503349127695695f0 /Doc/lib/libfuncs.tex | |
parent | 0f30dbd99166dfc8a501845b02ff27c96e294551 (diff) | |
download | cpython-e9ce25e512d455ae263600b67daef665a4ad13b5.zip cpython-e9ce25e512d455ae263600b67daef665a4ad13b5.tar.gz cpython-e9ce25e512d455ae263600b67daef665a4ad13b5.tar.bz2 |
Fix SF #642742, property() builtin not documented
Added doc for functions new to 2.2: classmethod property staticmethod super
Taken from docstrings. Could use review.
Hope there wasn't a reason why these shouldn't have been added.
Backport candidate.
Diffstat (limited to 'Doc/lib/libfuncs.tex')
-rw-r--r-- | Doc/lib/libfuncs.tex | 78 |
1 files changed, 78 insertions, 0 deletions
diff --git a/Doc/lib/libfuncs.tex b/Doc/lib/libfuncs.tex index 4716dd2..d29155d 100644 --- a/Doc/lib/libfuncs.tex +++ b/Doc/lib/libfuncs.tex @@ -85,6 +85,7 @@ def my_import(name): subclassed further. Its only instances are \code{False} and \code{True}. \indexii{Boolean}{type} +\versionadded{2.2.1} \end{funcdesc} \begin{funcdesc}{buffer}{object\optional{, offset\optional{, size}}} @@ -114,6 +115,29 @@ def my_import(name): if \var{i} is outside that range. \end{funcdesc} +\begin{funcdesc}{classmethod}{function} + Return a class method for \var{function}. + + A class method receives the class as implicit first argument, + just like an instance method receives the instance. + To declare a class method, use this idiom: + +\begin{verbatim} +class C: + def f(cls, arg1, arg2, ...): ... + f = classmethod(f) +\end{verbatim} + + It can be called either on the class (e.g. C.f()) or on an instance + (e.g. C().f()). The instance is ignored except for its class. + If a class method is called for a derived class, the derived class + object is passed as the implied first argument. + + Class methods are different than C++ or Java static methods. + If you want those, see \ref{staticmethod}. + \versionadded{2.2} +\end{funcdesc} + \begin{funcdesc}{cmp}{x, y} Compare the two objects \var{x} and \var{y} and return an integer according to the outcome. The return value is negative if \code{\var{x} @@ -679,6 +703,25 @@ def my_import(name): rounding accidents.) \end{funcdesc} +\begin{funcdesc}{property}{\optional{fget\optional{, fset\optional{, fdel\optional{, doc}}}}} + Return a property attribute for new-style classes (classes that + derive from \function{object}. + + \var{fget} is a function for getting an attribute value, likewise + \var{fset} is a function for setting, and \var{fdel} a function + for del'ing, an attribute. Typical use is to define a managed attribute x: + +\begin{verbatim} +class C(object): + def getx(self): return self.__x + def setx(self, value): self.__x = value + def delx(self): del self.__x + x = property(getx, setx, delx, "I'm the 'x' property.") +\end{verbatim} + + \versionadded{2.2} +\end{funcdesc} + \begin{funcdesc}{range}{\optional{start,} stop\optional{, step}} This is a versatile function to create lists containing arithmetic progressions. It is most often used in \keyword{for} loops. The @@ -826,6 +869,41 @@ def my_import(name): \samp{a[start:stop, i]}. \end{funcdesc} +\begin{funcdesc}{staticmethod}{function} + Return a static method for \var{function}. + + A static method does not receive an implicit first argument. + To declare a static method, use this idiom: + +\begin{verbatim} +class C: + def f(arg1, arg2, ...): ... + f = staticmethod(f) +\end{verbatim} + + It can be called either on the class (e.g. C.f()) or on an instance + (e.g. C().f()). The instance is ignored except for its class. + + Static methods in Python are similar to those found in Java or C++. + For a more advanced concept, see \ref{classmethod}. + \versionadded{2.2} +\end{funcdesc} + +\begin{funcdesc}{super}{type\optional{object-or-type}} + Return the superclass of \var{type}. If the second argument is omitted + the super object returned is unbound. If 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. + + A typical use for calling a cooperative superclass method is: +\begin{verbatim} +class C(B): + def meth(self, arg): + super(C, self).meth(arg) +\end{verbatim} +\versionadded{2.2} +\end{funcdesc} + \begin{funcdesc}{str}{object} Return a string containing a nicely printable representation of an object. For strings, this returns the string itself. The |