Anonymous committed 54e80db

document PyErr_Format

  • Participants
  • Parent commits 179a6e2
  • Branches legacy-trunk

Comments (0)

Files changed (2)

File Doc/api/api.tex

 You need not increment its reference count.
+\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{}.
 \begin{cfuncdesc}{void}{PyErr_SetNone}{PyObject *type}
 This is a shorthand for \samp{PyErr_SetObject(\var{type}, Py_None)}.

File Doc/api/refcounts.dat