https://github.com/python/cpython/commit/2bac2b86b1486f15038fb246835e04bb1b213cd8
commit: 2bac2b86b1486f15038fb246835e04bb1b213cd8
branch: main
author: Donghee Na <donghee...@python.org>
committer: corona10 <donghee.n...@gmail.com>
date: 2024-07-16T10:16:41+09:00
summary:
gh-121403: Add notes for PyList_GetXXX APIs about the need for init (gh-121626)
files:
M Doc/c-api/list.rst
diff --git a/Doc/c-api/list.rst b/Doc/c-api/list.rst
index 53eb54d3e1021a..758415a76e5cb4 100644
--- a/Doc/c-api/list.rst
+++ b/Doc/c-api/list.rst
@@ -38,9 +38,12 @@ List Objects
.. note::
If *len* is greater than zero, the returned list object's items are
- set to ``NULL``. Thus you cannot use abstract API functions such as
- :c:func:`PySequence_SetItem` or expose the object to Python code before
- setting all items to a real object with :c:func:`PyList_SetItem`.
+ set to ``NULL``. Thus you cannot use abstract API functions such as
+ :c:func:`PySequence_SetItem` or expose the object to Python code before
+ setting all items to a real object with :c:func:`PyList_SetItem` or
+ :c:func:`PyList_SET_ITEM()`. The following APIs are safe APIs before
+ the list is fully initialized: :c:func:`PyList_SetItem()` and
:c:func:`PyList_SET_ITEM()`.
+
.. c:function:: Py_ssize_t PyList_Size(PyObject *list)
_______________________________________________
Python-checkins mailing list -- python-checkins@python.org
To unsubscribe send an email to python-checkins-le...@python.org
https://mail.python.org/mailman3/lists/python-checkins.python.org/
Member address: arch...@mail-archive.com
