From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com> Date: Sat, 18 Jul 2026 18:18:22 +0000 (+0200) Subject: [3.15] gh-150663: Document that PyErr_SetRaisedException accepts null (GH-153046... X-Git-Url: http://git.ipfire.org/index.cgi?a=commitdiff_plain;h=e7966912569f8d2a28934856cffa791004fe40b2;p=thirdparty%2FPython%2Fcpython.git [3.15] gh-150663: Document that PyErr_SetRaisedException accepts null (GH-153046) (#154021) gh-150663: Document that PyErr_SetRaisedException accepts null (GH-153046) (cherry picked from commit a0c8329218402396478be92b691043453fc28c32) Co-authored-by: Andrii Hrimov --- diff --git a/Doc/c-api/exceptions.rst b/Doc/c-api/exceptions.rst index 312095ad85f8..d9074e671967 100644 --- a/Doc/c-api/exceptions.rst +++ b/Doc/c-api/exceptions.rst @@ -499,12 +499,12 @@ Querying the error indicator .. c:function:: void PyErr_SetRaisedException(PyObject *exc) Set *exc* as the exception currently being raised, - clearing the existing exception if one is set. + clearing the existing exception if one is set. If *exc* is ``NULL``, + just clear the existing exception. - .. warning:: + *exc* must be a valid exception or ``NULL``. - This call ":term:`steals `" a reference to *exc*, - which must be a valid exception. + This call ":term:`steals `" a reference to *exc*. .. versionadded:: 3.12