整數型對象?

所有整數都實(shí)現為長(cháng)度任意的長(cháng)整數對象。

在出錯時(shí)，大多數 PyLong_As* API 都會(huì )返回 (return type)-1，這與數字無(wú)法區分開(kāi)。請采用 PyErr_Occurred() 來(lái)加以區分。

type PyLongObject?

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

表示 Python 整數對象的 PyObject 子類(lèi)型。

PyTypeObject PyLong_Type?

Part of the Stable ABI.

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

int PyLong_Check(PyObject *p)?

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

int PyLong_CheckExact(PyObject *p)?

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

PyObject *PyLong_FromLong(long v)?

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

由 v 返回一個(gè)新的 PyLongObject 對象，失敗時(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 對象，失敗時(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 對象，失敗時(shí)返回 NULL 。

PyObject *PyLong_FromSize_t(size_t v)?

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

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

PyObject *PyLong_FromLongLong(long long v)?

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

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

PyObject *PyLong_FromUnsignedLongLong(unsigned long long v)?

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

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

PyObject *PyLong_FromDouble(double v)?

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

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

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

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

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

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

Return value: New reference.

將字符串 u 中的 Unicode 數字序列轉換為 Python 整數值。

3.3 新版功能.

PyObject *PyLong_FromVoidPtr(void *p)?

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

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

long PyLong_AsLong(PyObject *obj)?

Part of the Stable ABI.

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

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

出錯則返回 -1 。請用 PyErr_Occurred() 找出具體問(wèn)題。

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

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

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

Part of the Stable ABI.

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

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

出錯則返回 -1 。請用 PyErr_Occurred() 找出具體問(wèn)題。

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

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

long long PyLong_AsLongLong(PyObject *obj)?

Part of the Stable ABI.

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

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

出錯則返回 -1 。請用 PyErr_Occurred() 找出具體問(wèn)題。

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

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

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

Part of the Stable ABI.

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

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

出錯則返回 -1 。請用 PyErr_Occurred() 找出具體問(wèn)題。

3.2 新版功能.

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

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

Py_ssize_t PyLong_AsSsize_t(PyObject *pylong)?

Part of the Stable ABI.

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

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

出錯則返回 -1 。請用 PyErr_Occurred() 找出具體問(wèn)題。

unsigned long PyLong_AsUnsignedLong(PyObject *pylong)?

Part of the Stable ABI.

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

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

出錯時(shí)返回 (unsigned long)-1 ，請利用 PyErr_Occurred() 辨別具體問(wèn)題。

size_t PyLong_AsSize_t(PyObject *pylong)?

Part of the Stable ABI.

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

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

出錯時(shí)返回 (size_t)-1 ，請利用 PyErr_Occurred() 辨別具體問(wèn)題。

unsigned long long PyLong_AsUnsignedLongLong(PyObject *pylong)?

Part of the Stable ABI.

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

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

出錯時(shí)返回 (unsigned long long)-1，請利用 PyErr_Occurred() 辨別具體問(wèn)題。

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

unsigned long PyLong_AsUnsignedLongMask(PyObject *obj)?

Part of the Stable ABI.

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

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

出錯時(shí)返回 (unsigned long)-1，請利用 PyErr_Occurred() 辨別具體問(wèn)題。

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

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

unsigned long long PyLong_AsUnsignedLongLongMask(PyObject *obj)?

Part of the Stable ABI.

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

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

出錯時(shí)返回 (unsigned long long)-1，請利用 PyErr_Occurred() 辨別具體問(wèn)題。

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

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

double PyLong_AsDouble(PyObject *pylong)?

Part of the Stable ABI.

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

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

出錯時(shí)返回 -1.0 ，請利用 PyErr_Occurred() 辨別具體問(wèn)題。

void *PyLong_AsVoidPtr(PyObject *pylong)?

Part of the Stable ABI.

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

出錯時(shí)返回 NULL，請利用 PyErr_Occurred() 辨別具體問(wèn)題。