整數(shù)型對(duì)象?

所有整數(shù)都實(shí)現(xiàn)為長度任意的長整數(shù)對(duì)象。

在出錯(cuò)時(shí)，大多數(shù) PyLong_As* API 都會(huì)返回 (return type)-1，這與數(shù)字無法區(qū)分開。請(qǐng)采用 PyErr_Occurred() 來加以區(qū)分。

type PyLongObject?

Part of the Limited API (as an opaque struct).

表示 Python 整數(shù)對(duì)象的 PyObject 子類型。

PyTypeObject PyLong_Type?

Part of the Stable ABI.

這個(gè) PyTypeObject 的實(shí)例表示 Python 的整數(shù)類型。與 Python 語言中的 int 相同。

int PyLong_Check(PyObject *p)?

如果參數(shù)是 PyLongObject 或 PyLongObject 的子類型，則返回 True。該函數(shù)一定能夠執(zhí)行成功。

int PyLong_CheckExact(PyObject *p)?

如果其參數(shù)屬于 PyLongObject，但不是 PyLongObject 的子類型則返回真值。 此函數(shù)總是會(huì)成功執(zhí)行。

PyObject *PyLong_FromLong(long v)?

Return value: New reference. Part of the Stable ABI.

由 v 返回一個(gè)新的 PyLongObject 對(duì)象，失敗時(shí)返回 NULL 。

The current implementation keeps an array of integer objects for all integers between -5 and 256. When you create an int in that range you actually just get back a reference to the existing object.

PyObject *PyLong_FromUnsignedLong(unsigned long v)?

Return value: New reference. Part of the Stable ABI.

由 C unsigned long 返回一個(gè)新的 PyLongObject 對(duì)象，失敗時(shí)返回 NULL 。

PyObject *PyLong_FromSsize_t(Py_ssize_t v)?

Return value: New reference. Part of the Stable ABI.

由 C Py_ssize_t 返回一個(gè)新的 PyLongObject 對(duì)象，失敗時(shí)返回 NULL 。

PyObject *PyLong_FromSize_t(size_t v)?

Return value: New reference. Part of the Stable ABI.

由 C size_t 返回一個(gè)新的 PyLongObject 對(duì)象，失敗則返回 NULL 。

PyObject *PyLong_FromLongLong(long long v)?

Return value: New reference. Part of the Stable ABI.

由 C long long 返回一個(gè)新的 PyLongObject 對(duì)象，失敗則返回 NULL 。

PyObject *PyLong_FromUnsignedLongLong(unsigned long long v)?

Return value: New reference. Part of the Stable ABI.

由 C unsigned long long 返回一個(gè)新的 PyLongObject 對(duì)象，失敗則返回 NULL 。

PyObject *PyLong_FromDouble(double v)?

Return value: New reference. Part of the Stable ABI.

由 v 的整數(shù)部分返回一個(gè)新的 PyLongObject 對(duì)象，失敗則返回 NULL 。

PyObject *PyLong_FromString(const char *str, char **pend, int base)?

Return value: New reference. Part of the Stable ABI.

根據(jù) str 字符串值返回一個(gè)新的 PyLongObject ，base 指定了整數(shù)的基。如果 pend 不為 NULL ，則 /*pend 將指向 str 中表示數(shù)字部分后面的第一個(gè)字符。如果 base 為 0 ， str 將采用 整數(shù)字面值 的定義進(jìn)行解釋；這時(shí)非零十進(jìn)制數(shù)的前導(dǎo)零會(huì)觸發(fā) ValueError 。如果 base 不為 0 ，則須位于 2 和 36 之間（含 2 和 36）?；蠹皵?shù)字之間的前導(dǎo)空格、單下劃線將被忽略。如果不存在數(shù)字，將觸發(fā) ValueError。

PyObject *PyLong_FromUnicodeObject(PyObject *u, int base)?

Return value: New reference.

將字符串 u 中的 Unicode 數(shù)字序列轉(zhuǎn)換為 Python 整數(shù)值。

3.3 新版功能.

PyObject *PyLong_FromVoidPtr(void *p)?

Return value: New reference. Part of the Stable ABI.

從指針 p 創(chuàng)建一個(gè) Python 整數(shù)?？梢允褂?PyLong_AsVoidPtr() 返回的指針值。

long PyLong_AsLong(PyObject *obj)?

Part of the Stable ABI.

返回 obj 的 C 語言 long 形式。如果 obj 不是 PyLongObject 的實(shí)例，則會(huì)先調(diào)用其 __index__() 方法以轉(zhuǎn)換為 PyLongObject 。

如果 obj 的值超出了 long 的取值范圍，則會(huì)觸發(fā) OverflowError。

出錯(cuò)則返回 -1 。請(qǐng)用 PyErr_Occurred() 找出具體問題。

在 3.8 版更改: 如果可用將使用 __index__()。

在 3.10 版更改: 本函數(shù)不再使用 __int__() 。

long PyLong_AsLongAndOverflow(PyObject *obj, int *overflow)?

Part of the Stable ABI.

返回 obj 的 C 語言 long 形式。如果 obj 不是 PyLongObject 的實(shí)例，則會(huì)先調(diào)用其 __index__() 方法以轉(zhuǎn)換為 PyLongObject 。

如果 obj 的值大于 LONG_MAX 或小于 LONG_MIN，則會(huì)把 *overflow 分別置為``1`` 或 -1，并返回 1；否則，將 *overflow 置為 0。如果發(fā)生其他異常，則會(huì)按常規(guī)把 *overflow 置為 0，并返回 -1。

出錯(cuò)則返回 -1 。請(qǐng)用 PyErr_Occurred() 找出具體問題。

在 3.8 版更改: 如果可用將使用 __index__()。

在 3.10 版更改: 本函數(shù)不再使用 __int__() 。

long long PyLong_AsLongLong(PyObject *obj)?

Part of the Stable ABI.

返回 obj 的 C long long 表示形式。 如果 obj 不是 PyLongObject 的實(shí)例，則會(huì)先調(diào)用其 __index__() 方法以轉(zhuǎn)為 PyLongObject。

如果 obj 值超出 long long 的取值范圍，則會(huì)觸發(fā) OverflowError。

出錯(cuò)則返回 -1 。請(qǐng)用 PyErr_Occurred() 找出具體問題。

在 3.8 版更改: 如果可用將使用 __index__()。

在 3.10 版更改: 本函數(shù)不再使用 __int__() 。

long long PyLong_AsLongLongAndOverflow(PyObject *obj, int *overflow)?

Part of the Stable ABI.

返回 obj 的 C long long 表示形式。 如果 obj 不是 PyLongObject 的實(shí)例，則會(huì)先調(diào)用其 __index__() 方法以轉(zhuǎn)為 PyLongObject。

如果 obj 的值大于 LLONG_MAX 或小于 LLONG_MIN，則按常規(guī)將 *overflow 分別置為 1 或 -1，并返回 -1，否則將 *overflow 置為 0。如果觸發(fā)其他異常則 *overflow 置為 0 并返回 -1。

出錯(cuò)則返回 -1 。請(qǐng)用 PyErr_Occurred() 找出具體問題。

3.2 新版功能.

在 3.8 版更改: 如果可用將使用 __index__()。

在 3.10 版更改: 本函數(shù)不再使用 __int__() 。

Py_ssize_t PyLong_AsSsize_t(PyObject *pylong)?

Part of the Stable ABI.

返回 pylong 的 C 語言 Py_ssize_t 形式。pylong 必須是 PyLongObject 的實(shí)例。

如果 pylong 的值超出了 Py_ssize_t 的取值范圍則會(huì)引發(fā) OverflowError。

出錯(cuò)則返回 -1 。請(qǐng)用 PyErr_Occurred() 找出具體問題。

unsigned long PyLong_AsUnsignedLong(PyObject *pylong)?

Part of the Stable ABI.

返回 pylong 的 C unsigned long 形式。 pylong 必須是 PyLongObject 的實(shí)例。

如果 pylong 的值超出了 unsigned long 的取值范圍則會(huì)引發(fā) OverflowError。

出錯(cuò)時(shí)返回 (unsigned long)-1 ，請(qǐng)利用 PyErr_Occurred() 辨別具體問題。

size_t PyLong_AsSize_t(PyObject *pylong)?

Part of the Stable ABI.

返回 pylong 的 C 語言 size_t 形式。pylong 必須是 PyLongObject 的實(shí)例。

如果 pylong 的值超出了 size_t 的取值范圍則會(huì)引發(fā) OverflowError。

出錯(cuò)時(shí)返回 (size_t)-1 ，請(qǐng)利用 PyErr_Occurred() 辨別具體問題。

unsigned long long PyLong_AsUnsignedLongLong(PyObject *pylong)?

Part of the Stable ABI.

返回 pylong 的 C 語言 unsigned long long 形式。pylong 必須是 PyLongObject 的實(shí)例。

如果 pylong 的值超出了:c:type:unsigned long long 的取值范圍則會(huì)引發(fā) OverflowError。

出錯(cuò)時(shí)返回 (unsigned long long)-1，請(qǐng)利用 PyErr_Occurred() 辨別具體問題。

在 3.1 版更改: 現(xiàn)在 pylong 為負(fù)值會(huì)觸發(fā) OverflowError，而不是 TypeError。

unsigned long PyLong_AsUnsignedLongMask(PyObject *obj)?

Part of the Stable ABI.

返回 obj 的 C unsigned long 表示形式。 如果 obj 不是 PyLongObject 的實(shí)例，則會(huì)先調(diào)用其 __index__() 方法以轉(zhuǎn)為 PyLongObject。

如果 obj 的值超出了 unsigned long 的范圍，則返回該值對(duì) ULONG_MAX + 1 求模的差值。

出錯(cuò)時(shí)返回 (unsigned long)-1，請(qǐng)利用 PyErr_Occurred() 辨別具體問題。

在 3.8 版更改: 如果可用將使用 __index__()。

在 3.10 版更改: 本函數(shù)不再使用 __int__() 。

unsigned long long PyLong_AsUnsignedLongLongMask(PyObject *obj)?

Part of the Stable ABI.

返回 obj 的 C 語言 unsigned long long 格式。如果 obj 不是 PyLongObject 的實(shí)例，則會(huì)先調(diào)用其 __index__() 方法以轉(zhuǎn)為 PyLongObject。

如果 obj 的值超出了 unsigned long long 的范圍，則返回該值對(duì) ULLONG_MAX + 1 求模的差值。

出錯(cuò)時(shí)返回 (unsigned long long)-1，請(qǐng)利用 PyErr_Occurred() 辨別具體問題。

在 3.8 版更改: 如果可用將使用 __index__()。

在 3.10 版更改: 本函數(shù)不再使用 __int__() 。

double PyLong_AsDouble(PyObject *pylong)?

Part of the Stable ABI.

返回 pylong 的 C 語言 double 形式。pylong 必須是 PyLongObject 的實(shí)例。

如果 pylong 的值超出了:c:type:double 的取值范圍則會(huì)引發(fā) OverflowError。

出錯(cuò)時(shí)返回 -1.0 ，請(qǐng)利用 PyErr_Occurred() 辨別具體問題。

void *PyLong_AsVoidPtr(PyObject *pylong)?

Part of the Stable ABI.

將一個(gè) Python 整數(shù) pylong 轉(zhuǎn)換為 C 語言的 void 指針。 如果 pylong 無法轉(zhuǎn)換，則會(huì)觸發(fā) OverflowError。 這只是保證為 PyLong_FromVoidPtr() 創(chuàng)建的值產(chǎn)生一個(gè)合法的 void 指針。

出錯(cuò)時(shí)返回 NULL，請(qǐng)利用 PyErr_Occurred() 辨別具體問題。