序列协议¶
-
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.
Return the result of repeating sequence object返回序列对象 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 的从 i1 到 i2 切片。 这相当于 Python 语句
o[i1:i2] = v。
-
int PySequence_DelSlice(PyObject *o, Py_ssize_t i1, Py_ssize_t i2)¶
- 属于 稳定 ABI.
删除序列对象 o 的从 i1 到 i2 的切片。 失败时返回
-1。 这相当于 Python 语句del o[i1:i2]。
-
Py_ssize_t PySequence_Count(PyObject *o, PyObject *value)¶
- 属于 稳定 ABI.
返回 value 在 o 中出现的次数，即返回使得
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。
-
int PySequence_In(PyObject *o, PyObject *value)¶
- 属于 稳定 ABI.
Alias for
PySequence_Contains().自 3.14 版本弃用: The function is soft deprecated and should no longer be used to write new code.
-
Py_ssize_t PySequence_Index(PyObject *o, PyObject *value)¶
- 属于 稳定 ABI.
返回第一个索引*i*,其中
o[i] == value.出错时,返回-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 由
PySequence_Fast()返回且 o 不为NULL的情况下返回 o 长度。 也可以通过在 o 上调用PySequence_Size()来获取大小，但是PySequence_Fast_GET_SIZE()的速度更快因为它可以假定 o 为列表或元组。
-
PyObject *PySequence_Fast_GET_ITEM(PyObject *o, Py_ssize_t i)¶
- 返回值：借入的引用。
在 o 由
PySequence_Fast()返回且 o 不NULL，并且 i d在索引范围内的情况下返回 o 的第 i 号元素。
-
PyObject **PySequence_Fast_ITEMS(PyObject *o)¶
返回 PyObject 指针的底层数组。 假设 o 由
PySequence_Fast()返回且 o 不为NULL。请注意,如果列表调整大小,重新分配可能会重新定位items数组.因此,仅在序列无法更改的上下文中使用基础数组指针.
-
PyObject *PySequence_ITEM(PyObject *o, Py_ssize_t i)¶
- 返回值：新的引用。
返回 o 的第 i 个元素或在失败时返回
NULL。 此形式比PySequence_GetItem()理馔，但不会检查 o 上的PySequence_Check()是否为真值，也不会对负序号进行调整。