From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com>
Date: Fri, 20 Jun 2025 14:03:10 +0000 (+0200)
Subject: [3.13] Docs: Document `PyExceptionClass` functions in the C API (GH-135697) (GH-135758)
X-Git-Tag: v3.13.6~192
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=c6e26ef881471a9d1b68e72e203b5d346a5f5f9a;p=thirdparty%2FPython%2Fcpython.git

[3.13] Docs: Document `PyExceptionClass` functions in the C API (GH-135697) (GH-135758)

Docs: Document `PyExceptionClass` functions in the C API (GH-135697)

* Docs: Document `PyExceptionClass_Name`

`PyExceptionClass_Name` is an undocumented function in the limited API.

* Document `PyExceptionClass_Check`
(cherry picked from commit 59963e866a1bb8128a50cd53d1b13eeab03df06e)

Co-authored-by: Yuki Kobayashi <drsuaimqjgar@gmail.com>
---

diff --git a/Doc/c-api/exceptions.rst b/Doc/c-api/exceptions.rst
index bb1339db140f..e7ae464b8918 100644
--- a/Doc/c-api/exceptions.rst
+++ b/Doc/c-api/exceptions.rst
@@ -749,6 +749,16 @@ Exception Classes
    .. versionadded:: 3.2
 
 
+.. c:function:: int PyExceptionClass_Check(PyObject *ob)
+
+   Return non-zero if *ob* is an exception class, zero otherwise. This function always succeeds.
+
+
+.. c:function:: const char *PyExceptionClass_Name(PyObject *ob)
+
+   Return :c:member:`~PyTypeObject.tp_name` of the exception class *ob*.
+
+
 Exception Objects
 =================