https://github.com/python/cpython/commit/908695b5c74cb38a49da3e136eac46db9959fd57
commit: 908695b5c74cb38a49da3e136eac46db9959fd57
branch: 3.13
author: Peter Bierma <[email protected]>
committer: ZeroIntensity <[email protected]>
date: 2025-11-06T14:10:24Z
summary:

[3.13] gh-141004: Document `PyLong_FromPid` and `PyLong_AsPid` (GH-141028) 
(GH-141143)

* gh-141004: Document `PyLong_FromPid` and `PyLong_AsPid` (GH-141028)

Co-authored-by: Victor Stinner <[email protected]>
(cherry picked from commit bcc524f82d8548707046ce90f5bc56f60018767a)

files:
M Doc/c-api/long.rst

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

_______________________________________________
Python-checkins mailing list -- [email protected]
To unsubscribe send an email to [email protected]
https://mail.python.org/mailman3//lists/python-checkins.python.org
Member address: [email protected]

Reply via email to