序列协议

int PySequence_Check(PyObject *o)

Return 1 if the object provides sequence protocol, and 0 otherwise. This function always succeeds.

Py_ssize_t PySequence_Size(PyObject *o)

Py_ssize_t PySequence_Length(PyObject *o)

成功时返回序列中*o*的对象数,失败时返回``-1``. 相当于Python的``len(o)``表达式.

在 2.5 版更改: These functions returned an int type. This might require changes in your code for properly supporting 64-bit systems.

PyObject* PySequence_Concat(PyObject *o1, PyObject *o2)

Return value: New reference.

Return the concatenation of o1 and o2 on success, and NULL on failure. This is the equivalent of the Python expression 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.

在 2.5 版更改: This function used an int type for count. This might require changes in your code for properly supporting 64-bit systems.

PyObject* PySequence_InPlaceConcat(PyObject *o1, PyObject *o2)

Return value: New reference.

Return the concatenation of o1 and o2 on success, and NULL on failure. The operation is done in-place when o1 supports it. This is the equivalent of the Python expression 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.

在 2.5 版更改: This function used an int type for count. This might require changes in your code for properly supporting 64-bit systems.

PyObject* PySequence_GetItem(PyObject *o, Py_ssize_t i)

Return value: New reference.

Return the ith element of o, or NULL on failure. This is the equivalent of the Python expression o[i].

在 2.5 版更改: This function used an int type for i. This might require changes in your code for properly supporting 64-bit systems.

PyObject* PySequence_GetSlice(PyObject *o, Py_ssize_t i1, Py_ssize_t i2)

Return value: New reference.

Return the slice of sequence object o between i1 and i2, or NULL on failure. This is the equivalent of the Python expression o[i1:i2].

在 2.5 版更改: This function used an int type for i1 and i2. This might require changes in your code for properly supporting 64-bit systems.

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

将对象 v 赋值给 o 的第 i 号元素。 失败时会引发异常并返回 -1；成功时返回 0。 这相当于 Python 语句 o[i] = v。 此函数 不会 改变对 v 的引用。

If v is NULL, the element is deleted, however this feature is deprecated in favour of using PySequence_DelItem().

在 2.5 版更改: This function used an int type for i. This might require changes in your code for properly supporting 64-bit systems.

int PySequence_DelItem(PyObject *o, Py_ssize_t i)

删除对象 o 的第 i 号元素。 失败时返回 -1。 这相当于 Python 语句 del o[i]。

在 2.5 版更改: This function used an int type for i. This might require changes in your code for properly supporting 64-bit systems.

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

Assign the sequence object v to the slice in sequence object o from i1 to i2. Raise an exception and return -1 on failure; return 0 on success. This is the equivalent of the Python statement o[i1:i2] = v.

If v is NULL, the slice is deleted, however this feature is deprecated in favour of using PySequence_DelSlice().

在 2.5 版更改: This function used an int type for i1 and i2. This might require changes in your code for properly supporting 64-bit systems.

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

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

在 2.5 版更改: This function used an int type for i1 and i2. This might require changes in your code for properly supporting 64-bit systems.

Py_ssize_t PySequence_Count(PyObject *o, PyObject *value)

返回 value 在 o 中出现的次数，即返回使得 o[key] == value 的键的数量。 失败时返回 -1。 这相当于 Python 表达式 o.count(value)。

在 2.5 版更改: This function returned an int type. This might require changes in your code for properly supporting 64-bit systems.

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)``表达式.

在 2.5 版更改: This function returned an int type. This might require changes in your code for properly supporting 64-bit systems.

PyObject* PySequence_List(PyObject *o)

Return value: New reference.

Return a list object with the same contents as the arbitrary sequence o. The returned list is guaranteed to be new.

PyObject* PySequence_Tuple(PyObject *o)

Return value: New reference.

Return a tuple object with the same contents as the arbitrary sequence o or NULL on failure. If o is a tuple, a new reference will be returned, otherwise a tuple will be constructed with the appropriate contents. This is equivalent to the Python expression tuple(o).

PyObject* PySequence_Fast(PyObject *o, const char *m)

Return value: New reference.

Return the sequence o as a list, unless it is already a tuple or list, in which case o is returned. Use PySequence_Fast_GET_ITEM() to access the members of the result. Returns NULL on failure. If the object is not a sequence, raises TypeError with m as the message text.

PyObject* PySequence_Fast_GET_ITEM(PyObject *o, Py_ssize_t i)

Return value: Borrowed reference.

Return the ith element of o, assuming that o was returned by PySequence_Fast(), o is not NULL, and that i is within bounds.

在 2.5 版更改: This function used an int type for i. This might require changes in your code for properly supporting 64-bit systems.

PyObject** PySequence_Fast_ITEMS(PyObject *o)

Return the underlying array of PyObject pointers. Assumes that o was returned by PySequence_Fast() and o is not NULL.

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

2.4 新版功能.

PyObject* PySequence_ITEM(PyObject *o, Py_ssize_t i)

Return value: New reference.

Return the ith element of o or NULL on failure. Macro form of PySequence_GetItem() but without checking that PySequence_Check() on o is true and without adjustment for negative indices.

2.3 新版功能.

在 2.5 版更改: This function used an int type for i. This might require changes in your code for properly supporting 64-bit systems.

Py_ssize_t PySequence_Fast_GET_SIZE(PyObject *o)

Returns the length of o, assuming that o was returned by PySequence_Fast() and that o is not NULL. The size can also be gotten by calling PySequence_Size() on o, but PySequence_Fast_GET_SIZE() is faster because it can assume o is a list or tuple.