整数型对象¶
所有整数都使用以任意大小的长整数对象表示。
-
PyTypeObject
PyLong_Type
¶ 这个
PyTypeObject
的实例表示 Python 的整数类型。与Python层中的int
相同。
-
int
PyLong_Check
(PyObject *p)¶ 如果参数是
PyLongObject
或PyLongObject
的子类型,返回 true 。
-
int
PyLong_CheckExact
(PyObject *p)¶ 如果参数是
PyLongObject
但不是PyLongObject
的子类型,返回 true。
-
PyObject*
PyLong_FromLong
(long v)¶ - Return value: New reference.
Return a new
PyLongObject
object from v, or NULL on failure.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.
Return a new
PyLongObject
object from a Cunsigned long
, or NULL on failure.
-
PyObject*
PyLong_FromSsize_t
(Py_ssize_t v)¶ Return a new
PyLongObject
object from a CPy_ssize_t
, or NULL on failure.
-
PyObject*
PyLong_FromSize_t
(size_t v)¶ Return a new
PyLongObject
object from a Csize_t
, or NULL on failure.
-
PyObject*
PyLong_FromLongLong
(PY_LONG_LONG v)¶ - Return value: New reference.
Return a new
PyLongObject
object from a Clong long
, or NULL on failure.
-
PyObject*
PyLong_FromUnsignedLongLong
(unsigned PY_LONG_LONG v)¶ - Return value: New reference.
Return a new
PyLongObject
object from a Cunsigned long long
, or NULL on failure.
-
PyObject*
PyLong_FromDouble
(double v)¶ - Return value: New reference.
Return a new
PyLongObject
object from the integer part of v, or NULL on failure.
-
PyObject*
PyLong_FromString
(const char *str, char **pend, int base)¶ - Return value: New reference.
Return a new
PyLongObject
based on the string value in str, which is interpreted according to the radix in base. If pend is non-NULL, *pend will point to the first character in str which follows the representation of the number. If base is0
, str is interpreted using the 整型数字面值 definition; in this case, leading zeros in a non-zero decimal number raises aValueError
. If base is not0
, it must be between2
and36
, inclusive. Leading spaces and single underscores after a base specifier and between digits are ignored. If there are no digits,ValueError
will be raised.
-
PyObject*
PyLong_FromUnicode
(Py_UNICODE *u, Py_ssize_t length, int base)¶ - Return value: New reference.
Convert a sequence of Unicode digits to a Python integer value. The Unicode string is first encoded to a byte string using
PyUnicode_EncodeDecimal()
and then converted usingPyLong_FromString()
.Deprecated since version 3.3, will be removed in version 4.0: Part of the old-style
Py_UNICODE
API; please migrate to usingPyLong_FromUnicodeObject()
.
-
PyObject*
PyLong_FromUnicodeObject
(PyObject *u, int base)¶ Convert a sequence of Unicode digits in the string u to a Python integer value. The Unicode string is first encoded to a byte string using
PyUnicode_EncodeDecimal()
and then converted usingPyLong_FromString()
.3.3 新版功能.
-
PyObject*
PyLong_FromVoidPtr
(void *p)¶ - Return value: New reference.
从指针 p 创建一个 Python 整数。可以使用
PyLong_AsVoidPtr()
返回的指针值。
-
long
PyLong_AsLong
(PyObject *obj)¶ Return a C
long
representation of obj. If obj is not an instance ofPyLongObject
, first call its__int__()
method (if present) to convert it to aPyLongObject
.如果 obj 的值溢出了
long
的范围,会抛出OverflowError
。
-
long
PyLong_AsLongAndOverflow
(PyObject *obj, int *overflow)¶ Return a C
long
representation of obj. If obj is not an instance ofPyLongObject
, first call its__int__()
method (if present) to convert it to aPyLongObject
.If the value of obj is greater than
LONG_MAX
or less thanLONG_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.
-
PY_LONG_LONG
PyLong_AsLongLong
(PyObject *obj)¶ Return a C
long long
representation of obj. If obj is not an instance ofPyLongObject
, first call its__int__()
method (if present) to convert it to aPyLongObject
.如果 obj 的值溢出了
long
的范围,会抛出OverflowError
。
-
PY_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__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.3.2 新版功能.
-
Py_ssize_t
PyLong_AsSsize_t
(PyObject *pylong)¶ Return a C
Py_ssize_t
representation of pylong. pylong must be an instance ofPyLongObject
.Raise
OverflowError
if the value of pylong is out of range for aPy_ssize_t
.
-
unsigned long
PyLong_AsUnsignedLong
(PyObject *pylong)¶ Return a C
unsigned long
representation of pylong. pylong must be an instance ofPyLongObject
.Raise
OverflowError
if the value of pylong is out of range for aunsigned long
.
-
size_t
PyLong_AsSize_t
(PyObject *pylong)¶ Return a C
size_t
representation of pylong. pylong must be an instance ofPyLongObject
.Raise
OverflowError
if the value of pylong is out of range for asize_t
.
-
unsigned PY_LONG_LONG
PyLong_AsUnsignedLongLong
(PyObject *pylong)¶ Return a C
unsigned PY_LONG_LONG
representation of pylong. pylong must be an instance ofPyLongObject
.Raise
OverflowError
if the value of pylong is out of range for anunsigned PY_LONG_LONG
.在 3.1 版更改: A negative pylong now raises
OverflowError
, notTypeError
.
-
unsigned long
PyLong_AsUnsignedLongMask
(PyObject *obj)¶ Return a C
unsigned long
representation of obj. If obj is not an instance ofPyLongObject
, first call its__int__()
method (if present) to convert it to aPyLongObject
.If the value of obj is out of range for an
unsigned long
, return the reduction of that value moduloULONG_MAX + 1
.
-
unsigned PY_LONG_LONG
PyLong_AsUnsignedLongLongMask
(PyObject *obj)¶ Return a C
unsigned long long
representation of obj. If obj is not an instance ofPyLongObject
, first call its__int__()
method (if present) to convert it to aPyLongObject
.If the value of obj is out of range for an
unsigned long long
, return the reduction of that value moduloPY_ULLONG_MAX + 1
.
-
double
PyLong_AsDouble
(PyObject *pylong)¶ Return a C
double
representation of pylong. pylong must be an instance ofPyLongObject
.Raise
OverflowError
if the value of pylong is out of range for adouble
.
-
void*
PyLong_AsVoidPtr
(PyObject *pylong)¶ Convert a Python integer pylong to a C
void
pointer. If pylong cannot be converted, anOverflowError
will be raised. This is only assured to produce a usablevoid
pointer for values created withPyLong_FromVoidPtr()
.