序列协议

int PySequence_Check(PyObject *o)

返回 1 如果对象提供序列协议,并且 0 否则。注意它会返回 1 对于具有 __getitem__() 方法,除非 dict 子类,因为在一般情况下,不可能确定它支持的键的类型。此函数总是成功的。

Py_ssize_t PySequence_Size(PyObject *o)
Py_ssize_t PySequence_Length(PyObject *o)

按顺序返回对象数 o 论成功 -1 失败论。这相当于python表达式 len(o) .

PyObject *PySequence_Concat(PyObject *o1, PyObject *o2)
Return value: New reference.

返回的串联 o1o2 论成功 NULL 失败论。这相当于python表达式 o1 + o2 .

PyObject *PySequence_Repeat(PyObject *o, Py_ssize_t count)
Return value: New reference.

Return the result of repeating sequence object o count times, or NULL on failure. This is the equivalent of the Python expression o * count.

PyObject *PySequence_InPlaceConcat(PyObject *o1, PyObject *o2)
Return value: New reference.

返回的串联 o1o2 论成功 NULL 失败论。操作已完成 in-place 什么时候? o1 支持它。这相当于python表达式 o1 += o2 .

PyObject *PySequence_InPlaceRepeat(PyObject *o, Py_ssize_t count)
Return value: New reference.

Return the result of repeating sequence object o count times, or NULL on failure. The operation is done in-place when o supports it. This is the equivalent of the Python expression o *= count.

PyObject *PySequence_GetItem(PyObject *o, Py_ssize_t i)
Return value: New reference.

返回 i 钍元素 oNULL 失败论。这相当于python表达式 o[i] .

PyObject *PySequence_GetSlice(PyObject *o, Py_ssize_t i1, Py_ssize_t i2)
Return value: New reference.

返回序列对象的切片 o 之间 i1i2NULL 失败论。这相当于python表达式 o[i1:i2] .

int PySequence_SetItem(PyObject *o, Py_ssize_t i, PyObject *v)

分配对象 vith 元素 o . 引发异常并返回 -1 失败时;返回 0 论成功。这相当于python语句 o[i] = v . 这个函数 窃取对的引用 v .

如果 vNULL ,元素将被删除,但不赞成使用此功能,而赞成使用 PySequence_DelItem() .

int PySequence_DelItem(PyObject *o, Py_ssize_t i)

删除 i 对象的第个元素 o . 返回 -1 失败论。这相当于python语句 del o[i] .

int PySequence_SetSlice(PyObject *o, Py_ssize_t i1, Py_ssize_t i2, PyObject *v)

分配序列对象 v 到“按顺序切片”对象 oi1i2 . 这相当于python语句 o[i1:i2] = v .

int PySequence_DelSlice(PyObject *o, Py_ssize_t i1, Py_ssize_t i2)

删除序列中的切片对象 oi1i2 . 返回 -1 失败论。这相当于python语句 del o[i1:i2] .

Py_ssize_t PySequence_Count(PyObject *o, PyObject *value)

返回出现的次数 value 在里面 o ,即返回 o[key] == value . 失败时返回 -1 . 这相当于python表达式 o.count(value) .

int PySequence_Contains(PyObject *o, PyObject *value)

确定是否 o 包含 value . 如果一个项目 o 等于 value 返回 1 ,否则返回 0 . 出错时返回 -1 . 这相当于python表达式 value in o .

Py_ssize_t PySequence_Index(PyObject *o, PyObject *value)

返回第一个索引 i 为此 o[i] == value . 出错时返回 -1 .这相当于python表达式 o.index(value) .

PyObject *PySequence_List(PyObject *o)
Return value: New reference.

返回与序列或ITerable内容相同的列表对象 oNULL 失败时。返回的列表保证是新的。这相当于python表达式 list(o) .

PyObject *PySequence_Tuple(PyObject *o)
Return value: New reference.

返回与sequence或iterable内容相同的tuple对象 oNULL 失败论。如果 o 是一个元组,将返回一个新的引用,否则将使用适当的内容构造一个元组。这相当于python表达式 tuple(o) .

PyObject *PySequence_Fast(PyObject *o, const char *m)
Return value: New reference.

返回序列或iterable o 作为另一方可用的对象 PySequence_Fast* 功能系列。如果对象不是序列或iterable,则引发 TypeError 具有 m 作为消息文本。退换商品 NULL 失败论。

这个 PySequence_Fast* 因此命名函数是因为它们假定 o 是一个 PyTupleObject 或A PyListObject 并访问 o 直接。

作为CPython实现细节,如果 o 已经是序列或列表,将返回。

Py_ssize_t PySequence_Fast_GET_SIZE(PyObject *o)

返回的长度 o 假设 o 被归还 PySequence_Fast()o 不是 NULL . 也可以通过调用 PySequence_Size()o ,但是 PySequence_Fast_GET_SIZE() 更快,因为它可以假设 o 是列表或元组。

PyObject *PySequence_Fast_GET_ITEM(PyObject *o, Py_ssize_t i)
Return value: Borrowed reference.

返回 i 钍元素 o 假设 o 被归还 PySequence_Fast()o 不是 NULLi 在范围内。

PyObject **PySequence_Fast_ITEMS(PyObject *o)

返回PyObject指针的基础数组。假设 o 被归还 PySequence_Fast()o 不是 NULL .

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

PyObject *PySequence_ITEM(PyObject *o, Py_ssize_t i)
Return value: New reference.

返回 i 钍元素 oNULL 失败时。更快的形式 PySequence_GetItem() 但不检查那个 PySequence_Check()o 为真,不调整负指数。