Skip to content

Commit fa005af

Browse files
committed
Document Py_LL and Py_ULL.
1 parent 5d84b69 commit fa005af

File tree

1 file changed

+18
-0
lines changed

1 file changed

+18
-0
lines changed

Doc/c-api/intro.rst

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -264,6 +264,16 @@ complete listing.
264264
Like ``getenv(s)``, but returns ``NULL`` if :option:`-E` was passed on the
265265
command line (see :c:member:`PyConfig.use_environment`).
266266

267+
.. c:macro:: Py_LL(number)
268+
269+
Use *number* as a :c:type:`long long` integer literal.
270+
271+
This usally expands to *number* followed by ``LL``, but will expand to some
272+
compiler-specific suffixes (such as ``I64``) on older compilers.
273+
274+
In modern versions of Python, this macro is not very useful, as C99 and
275+
later require the ``LL`` suffix to be valid for an integer.
276+
267277
.. c:macro:: Py_LOCAL(type)
268278
269279
Declare a function returning the specified *type* using a fast-calling
@@ -328,6 +338,14 @@ complete listing.
328338

329339
.. versionadded:: 3.4
330340

341+
.. c:macro:: Py_ULL(number)
342+
343+
Similar to :c:macro:`Py_LL`, but *number* will be a :c:type:`unsigned long long`
344+
literal instead. This is done by appending ``U`` to the result of ``Py_LL``.
345+
346+
In modern versions of Python, this macro is not very useful, as C99 and
347+
later require the ``ULL``/``LLU`` suffix to be valid for an integer.
348+
331349
.. c:macro:: Py_UNREACHABLE()
332350
333351
Use this when you have a code path that cannot be reached by design.

0 commit comments

Comments
 (0)