https://github.com/python/cpython/commit/4c1d52934da853cdf42cf735689bae62d66c193e commit: 4c1d52934da853cdf42cf735689bae62d66c193e branch: 3.12 author: Hugo van Kemenade <[email protected]> committer: hugovk <[email protected]> date: 2025-03-17T14:59:12+02:00 summary:
[3.12] gh-124385: Document and soft-deprecate PyLong_AS_LONG (GH-124386) (#130549) (cherry picked from commit 425587a110eb214a097c634d4b6d944ac478923e) Co-authored-by: Petr Viktorin <[email protected]> files: M Doc/c-api/long.rst diff --git a/Doc/c-api/long.rst b/Doc/c-api/long.rst index 972d69a5194511..6e1cd1ece850e5 100644 --- a/Doc/c-api/long.rst +++ b/Doc/c-api/long.rst @@ -135,6 +135,16 @@ distinguished from a number. Use :c:func:`PyErr_Occurred` to disambiguate. .. versionchanged:: 3.10 This function will no longer use :meth:`~object.__int__`. + .. c:namespace:: NULL + + .. c:function:: long PyLong_AS_LONG(PyObject *obj) + + A :term:`soft deprecated` alias. + Exactly equivalent to the preferred ``PyLong_AsLong``. In particular, + it can fail with :exc:`OverflowError` or another exception. + + .. deprecated:: 3.14 + The function is soft deprecated. .. c:function:: long PyLong_AsLongAndOverflow(PyObject *obj, int *overflow) _______________________________________________ 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]
