From 00f148bfd66a6e01c03005650c3c38219ec37dc5 Mon Sep 17 00:00:00 2001 From: Peter Bierma Date: Thu, 6 Nov 2025 09:01:48 -0500 Subject: [PATCH 1/2] gh-141004: Document `PyLong_FromPid` and `PyLong_AsPid` (GH-141028) Co-authored-by: Victor Stinner (cherry picked from commit bcc524f82d8548707046ce90f5bc56f60018767a) --- Doc/c-api/long.rst | 22 ++++++++++++++++++++++ 1 file changed, 22 insertions(+) diff --git a/Doc/c-api/long.rst b/Doc/c-api/long.rst index 7dfb26d0ad5ea9..2d70f46f3e4897 100644 --- a/Doc/c-api/long.rst +++ b/Doc/c-api/long.rst @@ -141,6 +141,17 @@ distinguished from a number. Use :c:func:`PyErr_Occurred` to disambiguate. .. versionadded:: 3.13 +.. c:macro:: PyLong_FromPid(pid) + + Macro for creating a Python integer from a process identifier. + + This can be defined as an alias to :c:func:`PyLong_FromLong` or + :c:func:`PyLong_FromLongLong`, depending on the size of the system's + PID type. + + .. versionadded:: 3.2 + + .. c:function:: long PyLong_AsLong(PyObject *obj) .. index:: @@ -369,6 +380,17 @@ distinguished from a number. Use :c:func:`PyErr_Occurred` to disambiguate. Returns ``NULL`` on error. Use :c:func:`PyErr_Occurred` to disambiguate. +.. c:macro:: PyLong_AsPid(pid) + + Macro for converting a Python integer into a process identifier. + + This can be defined as an alias to :c:func:`PyLong_AsLong`, + :c:func:`PyLong_FromLongLong`, or :c:func:`PyLong_AsInt`, depending on the + size of the system's PID type. + + .. versionadded:: 3.2 + + .. c:function:: Py_ssize_t PyLong_AsNativeBytes(PyObject *pylong, void* buffer, Py_ssize_t n_bytes, int flags) Copy the Python integer value *pylong* to a native *buffer* of size From dfa521b7c3e4aaba64d4f80bb889c7fbb2fc676f Mon Sep 17 00:00:00 2001 From: Peter Bierma Date: Thu, 6 Nov 2025 09:04:12 -0500 Subject: [PATCH 2/2] [3.13] gh-141004: Document `PyLong_FromPid` and `PyLong_AsPid` (GH-141028) (cherry picked from commit bcc524f82d8548707046ce90f5bc56f60018767a) Co-authored-by: Peter Bierma Co-authored-by: Victor Stinner