Issue #7767: Add new C-API function PyLong_AsLongLongAndOverflow, a

long long variant of PyLong_AsLongAndOverflow.  Patch by Case Van
Horsen.

1 files changed, 13 insertions, 0 deletions

diff --git a/Doc/c-api/long.rst b/Doc/c-api/long.rst
index 7453ccd..b8fced5 100644
--- a/Doc/c-api/long.rst
+++ b/Doc/c-api/long.rst
@@ -146,6 +146,19 @@ Long Integer Objects
    .. versionadded:: 2.7
 
 
+.. cfunction:: PY_LONG_LONG PyLong_AsLongLongAndOverflow(PyObject *pylong, int* overflow)
+
+   Return a C :ctype:`long long` representation of the contents of
+   *pylong*.  If *pylong* is greater than :const:`PY_LLONG_MAX` or less
+   than :const:`PY_LLONG_MIN`, set `*overflow` to ``1`` or ``-1``,
+   respectively, and return ``-1``; otherwise, set `*overflow` to
+   ``0``.  If any other exception occurs (for example a TypeError or
+   MemoryError), then ``-1`` will be returned and ``*overflow`` will
+   be ``0``.
+
+   .. versionadded:: 2.7
+
+
 .. cfunction:: Py_ssize_t PyLong_AsSsize_t(PyObject *pylong)
 
    .. index::