PyTuple_Type
¶
此实例的
PyTypeObject
represents the Python tuple type; it is the same object as
tuple
and
types.TupleType
in the Python layer..
PyTuple_Check
(
PyObject
*p
)
¶
返回 True 若 p is a tuple object or an instance of a subtype of the tuple type.
2.2 版改变： Allowed subtypes to be accepted.
PyTuple_CheckExact
(
PyObject
*p
)
¶
返回 True 若 p is a tuple object, but not an instance of a subtype of the tuple type.
2.2 版新增。
PyTuple_New
(
Py_ssize_t
len
)
¶
Return a new tuple object of size len ，或 NULL 当故障时。
Changed in version 2.5:
This function used an
int
type for
len
. This might require changes in your code for properly supporting 64-bit systems.
PyTuple_Pack
(
Py_ssize_t
n
, ...
)
¶
Return a new tuple object of size
n
，或
NULL
on failure. The tuple values are initialized to the subsequent
n
C arguments pointing to Python objects.
PyTuple_Pack(2, a, b)
相当于
Py_BuildValue("(OO)", a, b)
.
2.4 版新增。
Changed in version 2.5:
This function used an
int
type for
n
. This might require changes in your code for properly supporting 64-bit systems.
PyTuple_Size
(
PyObject
*p
)
¶
Take a pointer to a tuple object, and return the size of that tuple.
Changed in version 2.5:
This function returned an
int
type. This might require changes in your code for properly supporting 64-bit systems.
PyTuple_GET_SIZE
(
PyObject
*p
)
¶
Return the size of the tuple p , which must be non- NULL and point to a tuple; no error checking is performed.
Changed in version 2.5:
This function returned an
int
type. This might require changes in your code for properly supporting 64-bit systems.
PyTuple_GetItem
(
PyObject
*p
, Py_ssize_t
pos
)
¶
Return the object at position
pos
in the tuple pointed to by
p
。若
pos
is out of bounds, return
NULL
and set an
IndexError
异常。
Changed in version 2.5:
This function used an
int
type for
pos
. This might require changes in your code for properly supporting 64-bit systems.
PyTuple_GET_ITEM
(
PyObject
*p
, Py_ssize_t
pos
)
¶
像
PyTuple_GetItem()
, but does no checking of its arguments.
Changed in version 2.5:
This function used an
int
type for
pos
. This might require changes in your code for properly supporting 64-bit systems.
PyTuple_GetSlice
(
PyObject
*p
, Py_ssize_t
low
, Py_ssize_t
high
)
¶
Return the slice of the tuple pointed to by
p
between
low
and
high
，或
NULL
on failure. This is the equivalent of the Python expression
p[low:high]
. Indexing from the end of the list is not supported.
Changed in version 2.5:
This function used an
int
type for
low
and
high
. This might require changes in your code for properly supporting 64-bit systems.
PyTuple_SetItem
(
PyObject
*p
, Py_ssize_t
pos
,
PyObject
*o
)
¶
Insert a reference to object
o
在位置
pos
of the tuple pointed to by
p
。返回
0
on success. If
pos
is out of bounds, return
-1
and set an
IndexError
异常。
注意
This function “steals” a reference to o and discards a reference to an item already in the tuple at the affected position.
Changed in version 2.5:
This function used an
int
type for
pos
. This might require changes in your code for properly supporting 64-bit systems.
PyTuple_SET_ITEM
(
PyObject
*p
, Py_ssize_t
pos
,
PyObject
*o
)
¶
像
PyTuple_SetItem()
, but does no error checking, and should
only
be used to fill in brand new tuples.
注意
This macro “steals” a reference to
o
, and, unlike
PyTuple_SetItem()
, does
not
discard a reference to any item that is being replaced; any reference in the tuple at position
pos
will be leaked.
Changed in version 2.5:
This function used an
int
type for
pos
. This might require changes in your code for properly supporting 64-bit systems.
_PyTuple_Resize
(
PyObject
**p
, Py_ssize_t
newsize
)
¶
Can be used to resize a tuple.
newsize
will be the new length of the tuple. Because tuples are
supposed
to be immutable, this should only be used if there is only one reference to the object. Do
not
use this if the tuple may already be known to some other part of the code. The tuple will always grow or shrink at the end. Think of this as destroying the old tuple and creating a new one, only more efficiently. Returns
0
on success. Client code should never assume that the resulting value of
*p
will be the same as before calling this function. If the object referenced by
*p
is replaced, the original
*p
is destroyed. On failure, returns
-1
并设置
*p
to
NULL
, and raises
MemoryError
or
SystemError
.
2.2 版改变： Removed unused third parameter, last_is_sticky .
Changed in version 2.5:
This function used an
int
type for
newsize
. This might require changes in your code for properly supporting 64-bit systems.
PyTuple_ClearFreeList
(
)
¶
Clear the free list. Return the total number of freed items.
2.6 版新增。