From: Peter Bierma <zintensitydev@gmail.com>
Date: Sun, 9 Nov 2025 17:09:09 +0000 (-0500)
Subject: gh-141004: Document `PyExceptionInstance*` APIs (GH-141301)
X-Git-Tag: v3.15.0a2~141
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=b5a0c72492800c7e999b87adfcfeabaacb4ecb97;p=thirdparty%2FPython%2Fcpython.git

gh-141004: Document `PyExceptionInstance*` APIs (GH-141301)

Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>
---

diff --git a/Doc/c-api/exceptions.rst b/Doc/c-api/exceptions.rst
index c58aa659e1b1..5241533e1128 100644
--- a/Doc/c-api/exceptions.rst
+++ b/Doc/c-api/exceptions.rst
@@ -788,6 +788,17 @@ Exception Classes
 Exception Objects
 =================
 
+.. c:function:: int PyExceptionInstance_Check(PyObject *op)
+
+   Return true if *op* is an instance of :class:`BaseException`, false
+   otherwise. This function always succeeds.
+
+
+.. c:macro:: PyExceptionInstance_Class(op)
+
+   Equivalent to :c:func:`Py_TYPE(op) <Py_TYPE>`.
+
+
 .. c:function:: PyObject* PyException_GetTraceback(PyObject *ex)
 
    Return the traceback associated with the exception as a new reference, as