diff options
author | Fred Drake <fdrake@acm.org> | 2001-10-26 16:38:38 (GMT) |
---|---|---|
committer | Fred Drake <fdrake@acm.org> | 2001-10-26 16:38:38 (GMT) |
commit | c44e9eca66712580aa19045a88c086f2ac9427bd (patch) | |
tree | 344f470be4e78e7a31afc775fc7a4fa3b50fe8dd /Doc | |
parent | 81c7aa2c7bb1e1fed170515599a2c023349e285e (diff) | |
download | cpython-c44e9eca66712580aa19045a88c086f2ac9427bd.zip cpython-c44e9eca66712580aa19045a88c086f2ac9427bd.tar.gz cpython-c44e9eca66712580aa19045a88c086f2ac9427bd.tar.bz2 |
Added docs for PyObject_CallFunctionObArgs() and PyObject_CallMethodObArgs().
Minor cleanups & markup consistency fixes.
Diffstat (limited to 'Doc')
-rw-r--r-- | Doc/api/abstract.tex | 43 |
1 files changed, 32 insertions, 11 deletions
diff --git a/Doc/api/abstract.tex b/Doc/api/abstract.tex index fae8475..2e85dac 100644 --- a/Doc/api/abstract.tex +++ b/Doc/api/abstract.tex @@ -183,31 +183,52 @@ determination. \bifuncindex{apply} \end{cfuncdesc} -\begin{cfuncdesc}{PyObject*}{PyObject_CallFunction}{PyObject *callable_object, - char *format, ...} - Call a callable Python object \var{callable_object}, with a variable +\begin{cfuncdesc}{PyObject*}{PyObject_CallFunction}{PyObject *callable, + char *format, \moreargs} + Call a callable Python object \var{callable}, with a variable number of C arguments. The C arguments are described using a \cfunction{Py_BuildValue()} style format string. The format may be \NULL, indicating that no arguments are provided. Returns the result of the call on success, or \NULL{} on failure. This is the - equivalent of the Python expression - \samp{apply(\var{callable_object}\var{args})} or - \samp{\var{callable_object}(*\var{args})}. + equivalent of the Python expression \samp{apply(\var{callable}, + \var{args})} or \samp{\var{callable}(*\var{args})}. \bifuncindex{apply} \end{cfuncdesc} \begin{cfuncdesc}{PyObject*}{PyObject_CallMethod}{PyObject *o, - char *method, char *format, ...} + char *method, char *format, + \moreargs} Call the method named \var{m} of object \var{o} with a variable number of C arguments. The C arguments are described by a \cfunction{Py_BuildValue()} format string. The format may be \NULL, indicating that no arguments are provided. Returns the result of the call on success, or \NULL{} on failure. This is the equivalent of - the Python expression \samp{\var{o}.\var{method}(\var{args})}. Note - that special method names, such as \method{__add__()}, - \method{__getitem__()}, and so on are not supported. The specific - abstract-object routines for these must be used. + the Python expression \samp{\var{o}.\var{method}(\var{args})}. +\end{cfuncdesc} + + +\begin{cfuncdesc}{PyObject*}{PyObject_CallFunctionObArgs}{PyObject *callable, + \moreargs, + \code{NULL}} + Call a callable Python object \var{callable}, with a variable + number of \ctype{PyObject*} arguments. The arguments are provided + as a variable number of parameters followed by \NULL. + Returns the result of the call on success, or \NULL{} on failure. + \versionadded{2.2} +\end{cfuncdesc} + + +\begin{cfuncdesc}{PyObject*}{PyObject_CallMethodObArgs}{PyObject *o, + PyObject *name, + \moreargs, + \code{NULL}} + Calls a method of the object \var{o}, where the name of the method + is given as a Python string object in \var{name}. It is called with + a variable number of \ctype{PyObject*} arguments. The arguments are + provided as a variable number of parameters followed by \NULL. + Returns the result of the call on success, or \NULL{} on failure. + \versionadded{2.2} \end{cfuncdesc} |