summaryrefslogtreecommitdiffstats
path: root/Doc/api/api.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Doc/api/api.tex')
-rw-r--r--Doc/api/api.tex11
1 files changed, 11 insertions, 0 deletions
diff --git a/Doc/api/api.tex b/Doc/api/api.tex
index d9e7fea..6b4786c 100644
--- a/Doc/api/api.tex
+++ b/Doc/api/api.tex
@@ -858,6 +858,17 @@ specify an arbitrary Python object for the ``value'' of the exception.
You need not increment its reference count.
\end{cfuncdesc}
+\begin{cfuncdesc}{PyObject*}{PyErr_Format}{PyObject *exception, const char *format, ...}
+This function sets the error indicator using a printf-style format
+string. The first argument specifies the exception type and the
+second argument specifies the format string for the exception. Any
+subsequent arguments are converted to output by the C library's
+\cfunction{vsprintf()} function. The buffer used internally by
+PyErr_Format is 500 bytes long. The caller is responsible for
+guaranteeing that the formatted output does not overflow the buffer.
+The return value is always \NULL{}.
+\end{cfuncdesc}
+
\begin{cfuncdesc}{void}{PyErr_SetNone}{PyObject *type}
This is a shorthand for \samp{PyErr_SetObject(\var{type}, Py_None)}.
\end{cfuncdesc}