整數物件¶
所有整数都实现为长度任意的长整数对象。
在出错时，大多数 PyLong_As* API 都会返回 (return type)-1，这与数字无法区分开。请采用 PyErr_Occurred() 来加以区分。
-
PyTypeObject
PyLong_Type¶ 这个
PyTypeObject的实例表示 Python 的整数类型。与 Python 语言中的int相同。
-
int
PyLong_Check(PyObject *p)¶ 如果参数是
PyLongObject或PyLongObject的子类型，返回 true 。
-
int
PyLong_CheckExact(PyObject *p)¶ 如果参数属于
PyLongObject，但不是PyLongObject的子类型则返回真值。
-
PyObject*
PyLong_FromLong(long v)¶ - Return value: New reference.
由 v 返回一个新的
PyLongObject对象，失败时返回NULL。The current implementation keeps an array of integer objects for all integers between
-5and256, when you create an int in that range you actually just get back a reference to the existing object. So it should be possible to change the value of1. I suspect the behaviour of Python in this case is undefined. :-)
-
PyObject*
PyLong_FromUnsignedLong(unsigned long v)¶ - Return value: New reference.
由 C
unsigned long类型返回一个新的PyLongObject对象，失败时返回NULL。
-
PyObject*
PyLong_FromSsize_t(Py_ssize_t v)¶ - Return value: New reference.
由 C
Py_ssize_t返回一个新的PyLongObject对象，失败时返回NULL。
-
PyObject*
PyLong_FromSize_t(size_t v)¶ - Return value: New reference.
由 C
size_t返回一个新的PyLongObject对象，失败则返回NULL。
-
PyObject*
PyLong_FromLongLong(long long v)¶ - Return value: New reference.
从 C
long long返回一个新的PyLongObject对象，失败时返回NULL。
-
PyObject*
PyLong_FromUnsignedLongLong(unsigned long long v)¶ - Return value: New reference.
从 C
unsigned long long返回一个新的PyLongObject对象，失败时返回NULL。
-
PyObject*
PyLong_FromDouble(double v)¶ - Return value: New reference.
由 v 的整数部分返回一个新的
PyLongObject对象，失败则返回NULL。
-
PyObject*
PyLong_FromString(const char *str, char **pend, int base)¶ - Return value: New reference.
根据 str 字符串值返回一个新的
PyLongObject，base 指定了整数的基。如果 pend 不为NULL，则 /*pend 将指向 str 中表示数字部分后面的第一个字符。如果 base 为0， str 将采用 整数字面值 的定义进行解释；这时非零十进制数的前导零会触发ValueError。如果 base 不为0，则须位于2和36之间（含 2 和 36）。基之后及数字之间的前导空格、单下划线将被忽略。如果不存在数字，将触发ValueError。
-
PyObject*
PyLong_FromUnicode(Py_UNICODE *u, Py_ssize_t length, int base)¶ - Return value: New reference.
将 Unicode 数字序列转换为 Python 整数值。
Deprecated since version 3.3, will be removed in version 3.10: 旧的
Py_UNICODEAPI的一部分;请迁移到使用PyLong_FromUnicodeObject()。
-
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.
从指针 p 创建一个 Python 整数。可以使用
PyLong_AsVoidPtr()返回的指针值。
-
long
PyLong_AsLong(PyObject *obj)¶ 返回 obj 的 C
long表达方式。 如果 obj 不是PyLongObject的实例，先调用它的__index__()或__int__()方法(如果有)将其转换为PyLongObject。如果 obj 的值溢出了
long的范围，会引发OverflowError。出错则返回
-1。请用PyErr_Occurred()找出具体问题。3.8 版更變: 如果可用将使用
__index__()。3.8 版後已棄用:
__int__()已被弃用。
-
long
PyLong_AsLongAndOverflow(PyObject *obj, int *overflow)¶ 返回 obj 的 C
long表达方式。 如果 obj 不是PyLongObject的实例，先调用它的__index__()或__int__()方法(如果有)将其转换为PyLongObject。如果 obj 的值大于
LONG_MAX或小于LONG_MIN，则会把 *overflow 分别置为``1`` 或-1，并返回1；否则，将 *overflow 置为 0。如果发生其他异常，则会按常规把 *overflow 置为0，并返回-1。出错则返回
-1。请用PyErr_Occurred()找出具体问题。3.8 版更變: 如果可用将使用
__index__()。3.8 版後已棄用:
__int__()已被弃用。
-
long long
PyLong_AsLongLong(PyObject *obj)¶ Return a C
long longrepresentation of obj. If obj is not an instance ofPyLongObject, first call its__index__()or__int__()method (if present) to convert it to aPyLongObject.如果 obj 值超出
long long，触发OverflowError出错则返回
-1。请用PyErr_Occurred()找出具体问题。3.8 版更變: 如果可用将使用
__index__()。3.8 版後已棄用:
__int__()已被弃用。
-
long long
PyLong_AsLongLongAndOverflow(PyObject *obj, int *overflow)¶ Return a C
long longrepresentation of obj. If obj is not an instance ofPyLongObject, first call its__index__()or__int__()method (if present) to convert it to aPyLongObject.If the value of obj is greater than
PY_LLONG_MAXor less thanPY_LLONG_MIN, set *overflow to1or-1, respectively, and return-1; otherwise, set *overflow to0. If any other exception occurs set *overflow to0and return-1as usual.出错则返回
-1。请用PyErr_Occurred()找出具体问题。3.2 版新加入.
3.8 版更變: 如果可用将使用
__index__()。3.8 版後已棄用:
__int__()已被弃用。
-
Py_ssize_t
PyLong_AsSsize_t(PyObject *pylong)¶ 返回 pylong 的 C 语言
Py_ssize_t形式。pylong 必须是PyLongObject的实例。如果 pylong 的值超出了
Py_ssize_t的取值范围则会引发OverflowError。出错则返回
-1。请用PyErr_Occurred()找出具体问题。
-
unsigned long
PyLong_AsUnsignedLong(PyObject *pylong)¶ 返回 pylong 的 C
unsigned long形式。 pylong 必须是PyLongObject的实例。如果 pylong 的值超出了
unsigned long的取值范围则会引发OverflowError。出错时返回
(unsigned long)-1，请利用PyErr_Occurred()辨别具体问题。
-
size_t
PyLong_AsSize_t(PyObject *pylong)¶ 返回 pylong 的 C 语言
size_t形式。pylong 必须是PyLongObject的实例。如果 pylong 的值超出了
size_t的取值范围则会引发OverflowError。出错时返回
(size_t)-1，请利用PyErr_Occurred()辨别具体问题。
-
unsigned long long
PyLong_AsUnsignedLongLong(PyObject *pylong)¶ 返回 pylong 的 C 语言
unsigned long long形式。pylong 必须是PyLongObject的实例。如果 pylong 的值超出了
unsigned long long的取值范围则会引发OverflowError。出错时返回
(unsigned long long)-1，请利用PyErr_Occurred()辨别具体问题。3.1 版更變: 现在 pylong 为负值会触发
OverflowError，而不是TypeError。
-
unsigned long
PyLong_AsUnsignedLongMask(PyObject *obj)¶ 返回 obj 的 C
unsigned long表示形式。 如果 obj 不是PyLongObject的实例，则会先调用其__index__()或__int__()方法（如果有的话）将其转为PyLongObject。如果 obj 的值超出了
unsigned long的范围，则返回该值对ULONG_MAX + 1求模的差值。出错时返回
(unsigned long)-1，请利用PyErr_Occurred()辨别具体问题。3.8 版更變: 如果可用将使用
__index__()。3.8 版後已棄用:
__int__()已被弃用。
-
unsigned long long
PyLong_AsUnsignedLongLongMask(PyObject *obj)¶ 返回 obj 的 C
unsigned long long表示形式。 如果 obj 不是PyLongObject的实例，则会先调用其__index__()或__int__()方法（如果有的话）将其转为PyLongObject。If the value of obj is out of range for an
unsigned long long, return the reduction of that value moduloPY_ULLONG_MAX + 1.出错时返回
(unsigned long long)-1，请利用PyErr_Occurred()辨别具体问题。3.8 版更變: 如果可用将使用
__index__()。3.8 版後已棄用:
__int__()已被弃用。
-
double
PyLong_AsDouble(PyObject *pylong)¶ 返回 pylong 的 C 语言
double形式。pylong 必须是PyLongObject的实例。如果 pylong 的值超出了
double的取值范围则会引发OverflowError。出错时返回
-1.0，请利用PyErr_Occurred()辨别具体问题。
-
void*
PyLong_AsVoidPtr(PyObject *pylong)¶ 将一个 Python 整数 pylong 转换为 C 语言的
void指针。 如果 pylong 无法转换，则会触发OverflowError。 这只是保证为PyLong_FromVoidPtr()创建的值产生一个合法的void指针。出错时返回
NULL，请利用PyErr_Occurred()辨别具体问题。