Skip to content

gh-120389: Add PyLong_FromInt64() and PyLong_AsInt64() #120390

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
vstinner merged 12 commits into from
Aug 28, 2024
Merged

gh-120389: Add PyLong_FromInt64() and PyLong_AsInt64() #120390

Changes from 1 commit
Commits
Show all changes
12 commits
Select commit Hold shift + click to select a range
3e50341
gh-120389: Add PyLong_FromInt64() and PyLong_ToInt64()
vstinner Jun 12, 2024
7c7b976
Add uint32_t to Doc/conf.py
vstinner Jun 19, 2024
c239d18
Use PyLong_AsNativeBytes()
vstinner Jun 20, 2024
1186043
Group documentations
vstinner Jun 20, 2024
c2150c1
Replace "To" with "As"
vstinner Aug 27, 2024
050f415
Merge branch 'main' into stdint
vstinner Aug 27, 2024
830d250
Use Py_ASNATIVEBYTES_ALLOW_INDEX
vstinner Aug 27, 2024
42b9902
stable_abi: replace "To" with "As"
vstinner Aug 27, 2024
0199a80
Address Bénédikt's review
vstinner Aug 27, 2024
71748a7
Remove check_long_asunsignedint() in tests
vstinner Aug 28, 2024
dd2194e
Update Doc/c-api/long.rst
vstinner Aug 28, 2024
7070514
Update Doc/c-api/long.rst
vstinner Aug 28, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
Group documentations
  • Loading branch information
@vstinner
vstinner committed Jun 20, 2024
commit 118604366c2698c943e7e0709cffafa1094fd224
49 changes: 11 additions & 38 deletions Doc/c-api/long.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -70,17 +70,10 @@ distinguished from a number. Use :c:func:`PyErr_Occurred` to disambiguate.


.. c:function:: PyObject* PyLong_FromInt32(int32_t value)
PyObject* PyLong_FromInt64(int64_t value)

Return a new :c:type:`PyLongObject` object from a signed C
:c:expr:`int32_t`, or ``NULL`` on failure.

.. versionadded:: 3.14


.. c:function:: PyObject* PyLong_FromInt64(int64_t value)

Return a new :c:type:`PyLongObject` object from a signed C
:c:expr:`int64_t`, or ``NULL`` on failure.
:c:expr:`int32_t` or :c:expr:`int64_t`, or ``NULL`` on failure.
Comment thread
vstinner marked this conversation as resolved.
Outdated

.. versionadded:: 3.14

Expand All @@ -92,17 +85,10 @@ distinguished from a number. Use :c:func:`PyErr_Occurred` to disambiguate.


.. c:function:: PyObject* PyLong_FromUInt32(uint32_t value)
PyObject* PyLong_FromUInt64(uint64_t value)

Return a new :c:type:`PyLongObject` object from an unsigned C
:c:expr:`uint32_t`, or ``NULL`` on failure.

.. versionadded:: 3.14


.. c:function:: PyObject* PyLong_FromUInt64(uint64_t value)

Return a new :c:type:`PyLongObject` object from an unsigned C
:c:expr:`uint64_t`, or ``NULL`` on failure.
:c:expr:`uint32_t` or :c:expr:`uint64_t`, or ``NULL`` on failure.
Comment thread
vstinner marked this conversation as resolved.
Outdated

.. versionadded:: 3.14

Expand Down Expand Up @@ -370,8 +356,10 @@ distinguished from a number. Use :c:func:`PyErr_Occurred` to disambiguate.


.. c:function:: int PyLong_ToInt32(PyObject *obj, int32_t *value)
int PyLong_ToInt64(PyObject *obj, int64_t *value)

Return a signed C :c:expr:`int32_t` representation of *obj*.
Return a signed C :c:expr:`int32_t` or :c:expr:`int64_t` representation of
Comment thread
vstinner marked this conversation as resolved.
Outdated
*obj*.

If the *obj* value is out of range, raise an :exc:`OverflowError`.

Expand All @@ -381,40 +369,25 @@ distinguished from a number. Use :c:func:`PyErr_Occurred` to disambiguate.
.. versionadded:: 3.14


.. c:function:: int PyLong_ToInt64(PyObject *obj, int64_t *value)

Similar to :c:func:`PyLong_ToInt32`, but return a signed C
:c:expr:`int64_t` representation.

.. versionadded:: 3.14


.. c:function:: int PyLong_ToUInt32(PyObject *obj, uint32_t *value)
int PyLong_ToUInt64(PyObject *obj, uint64_t *value)

Return an unsigned C :c:expr:`uint32_t` representation of *obj*.
Return an unsigned C :c:expr:`uint32_t` or :c:expr:`uint64_t` representation
Comment thread
vstinner marked this conversation as resolved.
Outdated
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 *obj* is negative, raise a :exc:`ValueError`.
* If the *obj* value is out of :c:expr:`uint32_t` range, raise an
:exc:`OverflowError`.
* If the *obj* value is out of range, raise an :exc:`OverflowError`.

Set *\*value* and return ``0`` on success.
Set an exception and return ``-1`` on error.

.. versionadded:: 3.14


.. c:function:: int PyLong_ToUInt64(PyObject *obj, uint64_t *value)

Similar to :c:func:`PyLong_ToUInt32`, but return an unsigned C
:c:expr:`int64_t` representation.

.. versionadded:: 3.14


.. c:function:: double PyLong_AsDouble(PyObject *pylong)

Return a C :c:expr:`double` representation of *pylong*. *pylong* must be
Expand Down