元组对象

type PyTupleObject

PyObject 的这个子类型代表一个 Python 元组对象。

PyTypeObject PyTuple_Type

PyTypeObject的这个实例代表了Python元组类型；它与 Python 层中的 tuple 对象相同。

int PyTuple_Check(PyObject *p)

如果 p 是元组对象或元组类型的子类型的实例，则返回 true。

int PyTuple_CheckExact(PyObject *p)

如果 p 是元组对象，但不是元组类型的子类型的实例，则返回 true。

PyObject *PyTuple_New(Py_ssize_t len)

失败时返回大小为 len 或 NULL 的新元组对象。

PyObject *PyTuple_Pack(Py_ssize_t n, ...)

失败时返回大小为 n 或 NULL 的新元组对象。元组值被初始化为指向 Python 对象的后续 n C 参数。 PyTuple_Pack(2, a, b) 相当于 Py_BuildValue("(OO)", a, b)。

Py_ssize_t PyTuple_Size(PyObject *p)

获取一个指向元组对象的指针，并返回该元组的大小。

Py_ssize_t PyTuple_GET_SIZE(PyObject *p)

返回元组p的大小，必须是非NULL并指向一个元组；不执行错误检查。

PyObject *PyTuple_GetItem(PyObject *p, Py_ssize_t pos)

返回 p 指向的元组中位置 pos 处的对象。如果 pos 超出范围，则返回 NULL 并设置 IndexError 异常。

PyObject *PyTuple_GET_ITEM(PyObject *p, Py_ssize_t pos)

类似于 PyTuple_GetItem()，但不检查其参数。

PyObject *PyTuple_GetSlice(PyObject *p, Py_ssize_t low, Py_ssize_t high)

从 low 到 high 取 p 指向的元组的切片，并将其作为新元组返回。

int PyTuple_SetItem(PyObject *p, Py_ssize_t pos, PyObject *o): 在 p 指向的元组的位置 pos 处插入对对象 o 的引用。成功返回 0。

笔记

此函数“窃取”对 o 的引用。

void PyTuple_SET_ITEM(PyObject *p, Py_ssize_t pos, PyObject *o): 类似于 PyTuple_SetItem()，但不做错误检查，应该使用 only 来填充全新的元组。

笔记

此函数“窃取”对 o 的引用。

int _PyTuple_Resize(PyObject **p, Py_ssize_t newsize)

可用于调整元组的大小。 newsize 将是元组的新长度。因为元组 supposed 是不可变的，所以只有当对象只有一个引用时才应该使用它。如果代码的其他部分可能已经知道元组，请不要不使用它。元组最终将始终增长或缩小。将此视为销毁旧元组并创建一个新元组，只会更有效。成功返回 0。客户端代码永远不应该假设 *p 的结果值将与调用此函数之前相同。如果*p引用的对象被替换，原来的*p被破坏。失败时，返回 -1 并将 *p 设置为 NULL，并引发 MemoryError 或 SystemError。

int PyTuple_ClearFreeList()

清除空闲列表。返回已释放项目的总数。

结构序列对象

结构序列对象是 namedtuple() 对象的 C 等价物，即一个序列，其项目也可以通过属性访问。要创建结构序列，首先必须创建特定的结构序列类型。

PyTypeObject *PyStructSequence_NewType(PyStructSequence_Desc *desc)

从 desc 中的数据创建一个新的结构序列类型，如下所述。可以使用 PyStructSequence_New() 创建结果类型的实例。

void PyStructSequence_InitType(PyTypeObject *type, PyStructSequence_Desc *desc)

从 desc 就地初始化结构序列类型 type。

int PyStructSequence_InitType2(PyTypeObject *type, PyStructSequence_Desc *desc): 与 PyStructSequence_InitType 相同，但成功时返回 0，失败时返回 -1。

3.4 版中的新功能。

type PyStructSequence_Desc

包含要创建的结构序列类型的元信息。

场地	C型	意义
`name`	`char *`	结构序列类型的名称
`doc`	`char *`	指向该类型的文档字符串的指针或要省略的 NULL
`fields`	`PyStructSequence_Field *`	指向具有新类型字段名称的 NULL 终止数组的指针
`n_in_sequence`	`int`	Python 端可见的字段数（如果用作元组）

type PyStructSequence_Field

描述结构序列的字段。由于结构序列被建模为元组，因此所有字段的类型都为 PyObject*。 PyStructSequence_Desc 的 fields 数组中的索引决定了描述结构序列的哪个字段。

场地	C型	意义
`name`	`char *`	字段名称或 NULL 结束命名字段列表，设置为 PyStructSequence_UnnamedField 以保持未命名
`doc`	`char *`	字段文档字符串或 NULL 省略

char *PyStructSequence_UnnamedField

字段名称的特殊值以使其未命名。

PyObject *PyStructSequence_New(PyTypeObject *type)

创建 type 的实例，该实例必须使用 PyStructSequence_NewType() 创建。

PyObject *PyStructSequence_GetItem(PyObject *p, Py_ssize_t pos)

返回 p 指向的结构序列中位置 pos 处的对象。不执行边界检查。

PyObject *PyStructSequence_GET_ITEM(PyObject *p, Py_ssize_t pos)

相当于 PyStructSequence_GetItem() 的宏。

void PyStructSequence_SetItem(PyObject *p, Py_ssize_t pos, PyObject *o): 将结构序列 p 的索引 pos 处的字段设置为值 o。像 PyTuple_SET_ITEM()，这应该只用于填充全新的实例。

笔记

此函数“窃取”对 o 的引用。

void PyStructSequence_SET_ITEM(PyObject *p, Py_ssize_t *pos, PyObject *o): PyStructSequence_SetItem() 的宏等效项。

笔记

此函数“窃取”对 o 的引用。

元组对象 — Python 文档

元组对象

结构序列对象