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

(cherry picked from commit 8ade15343d5daec3bf79ff7c47f03726fb2bcadf)

Co-authored-by: RUANG (James Roy) <[email protected]>

CPython-sync-commit-latest: e1a20910dc6857df558bb9fb7e49c75405b09f06

Author: github-actions[bot]

.pot/latest/c-api/object.pot

@@ -8,7 +8,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.12\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2025-01-02 07:37+0000\n"
+"POT-Creation-Date: 2025-01-04 21:16+0000\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language-Team: LANGUAGE <[email protected]>\n"
@@ -247,54 +247,58 @@ msgid "Remove the mapping for the object *key* from the object *o*.  Return ``-1
 msgstr ""
 
 #: ../../c-api/object.rst:398
+msgid "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*`."
+msgstr ""
+
+#: ../../c-api/object.rst:405
 msgid "This is equivalent to the Python expression ``dir(o)``, returning a (possibly empty) list of strings appropriate for the object argument, or ``NULL`` if there was an error.  If the argument is ``NULL``, this is like the Python ``dir()``, returning the names of the current locals; in this case, if no execution frame is active then ``NULL`` is returned but :c:func:`PyErr_Occurred` will return false."
 msgstr ""
 
-#: ../../c-api/object.rst:407
+#: ../../c-api/object.rst:414
 msgid "This is equivalent to the Python expression ``iter(o)``. It returns a new iterator for the object argument, or the object  itself if the object is already an iterator.  Raises :exc:`TypeError` and returns ``NULL`` if the object cannot be iterated."
 msgstr ""
 
-#: ../../c-api/object.rst:415
+#: ../../c-api/object.rst:422
 msgid "This is equivalent to the Python ``__iter__(self): return self`` method. It is intended for :term:`iterator` types, to be used in the :c:member:`PyTypeObject.tp_iter` slot."
 msgstr ""
 
-#: ../../c-api/object.rst:421
+#: ../../c-api/object.rst:428
 msgid "This is the equivalent to the Python expression ``aiter(o)``. Takes an :class:`AsyncIterable` object and returns an :class:`AsyncIterator` for it. This is typically a new iterator but if the argument is an :class:`AsyncIterator`, this returns itself. Raises :exc:`TypeError` and returns ``NULL`` if the object cannot be iterated."
 msgstr ""
 
-#: ../../c-api/object.rst:431
+#: ../../c-api/object.rst:438
 msgid "Get a pointer to subclass-specific data reserved for *cls*."
 msgstr ""
 
-#: ../../c-api/object.rst:433
+#: ../../c-api/object.rst:440
 msgid "The object *o* must be an instance of *cls*, and *cls* must have been created using negative :c:member:`PyType_Spec.basicsize`. Python does not check this."
 msgstr ""
 
-#: ../../c-api/object.rst:437
+#: ../../c-api/object.rst:444
 msgid "On error, set an exception and return ``NULL``."
 msgstr ""
 
-#: ../../c-api/object.rst:443
+#: ../../c-api/object.rst:450
 msgid "Return the size of the instance memory space reserved for *cls*, i.e. the size of the memory :c:func:`PyObject_GetTypeData` returns."
 msgstr ""
 
-#: ../../c-api/object.rst:446
+#: ../../c-api/object.rst:453
 msgid "This may be larger than requested using :c:member:`-PyType_Spec.basicsize <PyType_Spec.basicsize>`; it is safe to use this larger size (e.g. with :c:func:`!memset`)."
 msgstr ""
 
-#: ../../c-api/object.rst:449
+#: ../../c-api/object.rst:456
 msgid "The type *cls* **must** have been created using negative :c:member:`PyType_Spec.basicsize`. Python does not check this."
 msgstr ""
 
-#: ../../c-api/object.rst:453
+#: ../../c-api/object.rst:460
 msgid "On error, set an exception and return a negative value."
 msgstr ""
 
-#: ../../c-api/object.rst:459
+#: ../../c-api/object.rst:466
 msgid "Get a pointer to per-item data for a class with :c:macro:`Py_TPFLAGS_ITEMS_AT_END`."
 msgstr ""
 
-#: ../../c-api/object.rst:462
+#: ../../c-api/object.rst:469
 msgid "On error, set an exception and return ``NULL``. :py:exc:`TypeError` is raised if *o* does not have :c:macro:`Py_TPFLAGS_ITEMS_AT_END` set."
 msgstr ""