序列协议

int PySequence_Check(PyObject *o)
属于稳定 ABI的一部分。

如果对象提供序列协议,则返回 1,否则返回 0。请注意,对于具有 __getitem__() 方法的 Python 类,它会返回 1,除非它们是 dict 子类,因为通常无法确定该类支持的键类型。此函数始终成功。

Py_ssize_t PySequence_Size(PyObject *o)
Py_ssize_t PySequence_Length(PyObject *o)
属于稳定 ABI的一部分。

成功时返回序列 *o* 中的对象数量,失败时返回 -1。这等效于 Python 表达式 len(o)

PyObject *PySequence_Concat(PyObject *o1, PyObject *o2)
返回值:新引用。属于稳定 ABI的一部分。

成功时返回 *o1* 和 *o2* 的串联,失败时返回 NULL。这等效于 Python 表达式 o1 + o2

PyObject *PySequence_Repeat(PyObject *o, Py_ssize_t count)
返回值:新引用。属于稳定 ABI的一部分。

返回将序列对象 *o* 重复 *count* 次的结果,失败时返回 NULL。这等效于 Python 表达式 o * count

PyObject *PySequence_InPlaceConcat(PyObject *o1, PyObject *o2)
返回值:新引用。属于稳定 ABI的一部分。

成功时返回 *o1* 和 *o2* 的串联,失败时返回 NULL。当 *o1* 支持时,该操作是 *就地* 完成的。这等效于 Python 表达式 o1 += o2

PyObject *PySequence_InPlaceRepeat(PyObject *o, Py_ssize_t count)
返回值:新引用。属于稳定 ABI的一部分。

返回将序列对象 *o* 重复 *count* 次的结果,失败时返回 NULL。当 *o* 支持时,该操作是 *就地* 完成的。这等效于 Python 表达式 o *= count

PyObject *PySequence_GetItem(PyObject *o, Py_ssize_t i)
返回值:新引用。属于稳定 ABI的一部分。

返回 *o* 的第 *i* 个元素,失败时返回 NULL。这等效于 Python 表达式 o[i]

PyObject *PySequence_GetSlice(PyObject *o, Py_ssize_t i1, Py_ssize_t i2)
返回值:新引用。属于稳定 ABI的一部分。

返回序列对象 *o* 中 *i1* 和 *i2* 之间的切片,失败时返回 NULL。这等效于 Python 表达式 o[i1:i2]

int PySequence_SetItem(PyObject *o, Py_ssize_t i, PyObject *v)
属于稳定 ABI的一部分。

将对象 *v* 赋值给 *o* 的第 *i* 个元素。失败时引发异常并返回 -1;成功时返回 0。这等效于 Python 语句 o[i] = v。此函数 *不会* 窃取对 *v* 的引用。

如果 *v* 是 NULL,则会删除该元素,但此功能已弃用,建议使用 PySequence_DelItem()

int PySequence_DelItem(PyObject *o, Py_ssize_t i)
属于稳定 ABI的一部分。

删除对象 *o* 的第 *i* 个元素。失败时返回 -1。这等效于 Python 语句 del o[i]

int PySequence_SetSlice(PyObject *o, Py_ssize_t i1, Py_ssize_t i2, PyObject *v)
属于稳定 ABI的一部分。

将序列对象 v 赋值给序列对象 o 中从 i1i2 的切片。这等价于 Python 语句 o[i1:i2] = v

int PySequence_DelSlice(PyObject *o, Py_ssize_t i1, Py_ssize_t i2)
属于稳定 ABI的一部分。

删除序列对象 o 中从 i1i2 的切片。失败时返回 -1。这等价于 Python 语句 del o[i1:i2]

Py_ssize_t PySequence_Count(PyObject *o, PyObject *value)
属于稳定 ABI的一部分。

返回 valueo 中出现的次数,也就是返回满足 o[key] == value 的键的数量。失败时,返回 -1。这等价于 Python 表达式 o.count(value)

int PySequence_Contains(PyObject *o, PyObject *value)
属于稳定 ABI的一部分。

确定 o 是否包含 value。如果 o 中的某个项等于 value,则返回 1,否则返回 0。发生错误时,返回 -1。这等价于 Python 表达式 value in o

Py_ssize_t PySequence_Index(PyObject *o, PyObject *value)
属于稳定 ABI的一部分。

返回满足 o[i] == value 的第一个索引 i。发生错误时,返回 -1。这等价于 Python 表达式 o.index(value)

PyObject *PySequence_List(PyObject *o)
返回值:新引用。属于稳定 ABI的一部分。

返回一个列表对象,其内容与序列或可迭代对象 o 相同,或者在失败时返回 NULL。返回的列表保证是新的。这等价于 Python 表达式 list(o)

PyObject *PySequence_Tuple(PyObject *o)
返回值:新引用。属于稳定 ABI的一部分。

返回一个元组对象,其内容与序列或可迭代对象 o 相同,或者在失败时返回 NULL。如果 o 是一个元组,则会返回一个新的引用,否则将构造一个具有适当内容的元组。这等价于 Python 表达式 tuple(o)

PyObject *PySequence_Fast(PyObject *o, const char *m)
返回值:新引用。属于稳定 ABI的一部分。

将序列或可迭代对象 o 返回为可供其他 PySequence_Fast* 函数系列使用的对象。如果该对象不是序列或可迭代对象,则会引发 TypeError,并使用 m 作为消息文本。失败时返回 NULL

之所以将 PySequence_Fast* 函数这样命名,是因为它们假定 o 是一个 PyTupleObject 或一个 PyListObject,并且直接访问 o 的数据字段。

作为 CPython 实现的细节,如果 o 已经是一个序列或列表,则会直接返回它。

Py_ssize_t PySequence_Fast_GET_SIZE(PyObject *o)

返回 o 的长度,假设 o 是由 PySequence_Fast() 返回的,并且 o 不是 NULL。也可以通过在 o 上调用 PySequence_Size() 来检索大小,但是 PySequence_Fast_GET_SIZE() 更快,因为它假设 o 是列表或元组。

PyObject *PySequence_Fast_GET_ITEM(PyObject *o, Py_ssize_t i)
返回值:借用引用。

返回 o 的第 i 个元素,假设 o 是由 PySequence_Fast() 返回的,o 不是 NULL,并且 i 在边界内。

PyObject **PySequence_Fast_ITEMS(PyObject *o)

返回 PyObject 指针的底层数组。假设 o 是由 PySequence_Fast() 返回的,并且 o 不是 NULL

请注意,如果列表调整了大小,重新分配可能会重新定位项数组。因此,只能在序列无法更改的上下文中使用底层数组指针。

PyObject *PySequence_ITEM(PyObject *o, Py_ssize_t i)
返回值:新引用。

返回 o 的第 i 个元素,如果失败则返回 NULL。它是 PySequence_GetItem() 的更快形式,但不会检查 oPySequence_Check() 是否为真,也不会调整负索引。