[3.12] gh-127954: Document PyObject_DelItemString (GH-127986) (#128497)

(cherry picked from commit 8ade15343d5daec3bf79ff7c47f03726fb2bcadf)

Co-authored-by: RUANG (James Roy) <rruuaanng@outlook.com>

diff --git a/Doc/c-api/object.rst b/Doc/c-api/object.rst
index cefd384fd35a1f45d251786df52719e8794477df..b7f1a54972e587cfcbf0c6057359fcfbb899ad91 100644 (file)
--- a/Doc/c-api/object.rst
+++ b/Doc/c-api/object.rst
@@ -393,6 +393,13 @@ Object Protocol
    on failure.  This is equivalent to the Python statement ``del o[key]``.
 
 
+.. c:function:: int PyObject_DelItemString(PyObject *o, const char *key)
+
+   This is the same as :c:func:`PyObject_DelItem`, but *key* is
+   specified as a :c:expr:`const char*` UTF-8 encoded bytes string,
+   rather than a :c:expr:`PyObject*`.
+
+
 .. c:function:: PyObject* PyObject_Dir(PyObject *o)
 
    This is equivalent to the Python expression ``dir(o)``, returning a (possibly