整数型对象¶
所有整数都实现为长度任意的长整数对象。
在出错时,大多数 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
-5
and256
, 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_UNICODE
API的一部分;请迁移到使用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 long
representation 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 long
representation 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_MAX
or less thanPY_LLONG_MIN
, set *overflow to1
or-1
, respectively, and return-1
; otherwise, set *overflow to0
. If any other exception occurs set *overflow to0
and return-1
as 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()
辨别具体问题。