diff options
author | Fred Drake <fdrake@acm.org> | 2002-06-13 11:53:54 +0000 |
---|---|---|
committer | Fred Drake <fdrake@acm.org> | 2002-06-13 11:53:54 +0000 |
commit | 279e4aea99d0eedc5802b1d22eaf25b788c2854f (patch) | |
tree | 9146ea0d50d86404b5e0a375aee2b64777c320cb | |
parent | 22d7d613fb0c7e8a1bcf8b1f3969704353661e2a (diff) | |
download | cpython-279e4aea99d0eedc5802b1d22eaf25b788c2854f.tar.gz |
Add documentation for PyObject_RichCompare() and PyObject_RichCompareBool(),
constributed by David Abrahams.
This closes SF patch #568081.
-rw-r--r-- | Doc/api/api.tex | 42 |
1 files changed, 42 insertions, 0 deletions
diff --git a/Doc/api/api.tex b/Doc/api/api.tex index 2df59f5ee4..6a9a8eb5da 100644 --- a/Doc/api/api.tex +++ b/Doc/api/api.tex @@ -1477,6 +1477,48 @@ statement \samp{del \var{o}.\var{attr_name}}. \end{cfuncdesc} +\begin{cfuncdesc}{PyObject*}{PyObject_RichCompare}{PyObject *o1, + PyObject *o2, int op} + Compare the values of \var{o1} and \var{o2} using the operation + specified by \var{op}, which must be one of + \constant{Py_LT}, + \constant{Py_LE}, + \constant{Py_EQ}, + \constant{Py_NE}, + \constant{Py_GT}, or + \constant{Py_GE}, corresponding to + \code{<}, + \code{<=}, + \code{==}, + \code{!=}, + \code{>}, or + \code{>=} respectively. This is the equivalent of the Python expression + \samp{\var{o1} \emph{op} \var{o2}}, where \emph{op} is the operator + corresponding to \var{op}. Returns the value of the comparison on + success, or \NULL{} on failure. +\end{cfuncdesc} + +\begin{cfuncdesc}{int}{PyObject_RichCompareBool}{PyObject *o1, + PyObject *o2, int op} + Compare the values of \var{o1} and \var{o2} using the operation + specified by \var{op}, which must be one of + \constant{Py_LT}, + \constant{Py_LE}, + \constant{Py_EQ}, + \constant{Py_NE}, + \constant{Py_GT}, or + \constant{Py_GE}, corresponding to + \code{<}, + \code{<=}, + \code{==}, + \code{!=}, + \code{>}, or + \code{>=} respectively. Returns \code{-1} on error, \code{0} if the + result is false, \code{1} otherwise. This is the equivalent of the + Python expression \samp{\var{o1} \emph{op} \var{o2}}, where + \emph{op} is the operator corresponding to \var{op}. +\end{cfuncdesc} + \begin{cfuncdesc}{int}{PyObject_Cmp}{PyObject *o1, PyObject *o2, int *result} Compare the values of \var{o1} and \var{o2} using a routine provided by \var{o1}, if one exists, otherwise with a routine provided by |