https://github.com/python/cpython/commit/4dd85b347fd8264453811e0873e0dffa333d9838
commit: 4dd85b347fd8264453811e0873e0dffa333d9838
branch: main
author: Sergey B Kirpichev <skirpic...@gmail.com>
committer: encukou <encu...@gmail.com>
date: 2025-08-04T15:30:29+02:00
summary:
gh-137368: document __index__() support for PyLong_AsInt32/64() (GH-137369)
files:
M Doc/c-api/long.rst
diff --git a/Doc/c-api/long.rst b/Doc/c-api/long.rst
index 2d0bda76697e81..31e2cd57034467 100644
--- a/Doc/c-api/long.rst
+++ b/Doc/c-api/long.rst
@@ -372,6 +372,10 @@ distinguished from a number. Use :c:func:`PyErr_Occurred`
to disambiguate.
Set *\*value* to a signed C :c:expr:`int32_t` or :c:expr:`int64_t`
representation of *obj*.
+ If *obj* is not an instance of :c:type:`PyLongObject`, first call its
+ :meth:`~object.__index__` method (if present) to convert it to a
+ :c:type:`PyLongObject`.
+
If the *obj* value is out of range, raise an :exc:`OverflowError`.
Set *\*value* and return ``0`` on success.
_______________________________________________
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
