序列協議

int PySequence_Check(PyObject?*o)

如果對象提供序列協議，函數返回 1，否則返回 0。 請注意它將為具有 __getitem__() 方法的 Python 類返回 1，除非它們是 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.

成功時返回 o1 和 o2 的拼接，失敗時返回 NULL。 這等價于 Python 表達式 o1 + o2。

PyObject* PySequence_Repeat(PyObject?*o, Py_ssize_t?count)

Return value: New reference.

返回序列對象 o 重復 count 次的結果，失敗時返回 NULL。 這等價于 Python 表達式 o * count。

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

Return value: New reference.

成功時返回 o1 和 o2 的拼接，失敗時返回 NULL。 在 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 次的結果，失敗時返回 NULL。 在 o 支持的情況下該操作會 原地 完成。 這等價于 Python 表達式 o *= count。

PyObject* PySequence_GetItem(PyObject?*o, Py_ssize_t?i)

Return value: New reference.

返回 o 中的第 i 號元素，失敗時返回 NULL。 這等價于 Python 表達式 o[i]。

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

Return value: New reference.

返回序列對象 o 的 i1 到 i2 的切片，失敗時返回 NULL。 這等價于 Python 表達式 o[i1:i2]。

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

將對象 v 賦值給 o 的第 i 號元素。 失敗時會引發異常并返回 -1；成功時返回 0。 這相當于 Python 語句 o[i] = v。 此函數 不會 改變對 v 的引用。

如果 v 為 NULL，元素將被刪除，但是此特性已被棄用，應當改用 PySequence_DelItem()。

int PySequence_DelItem(PyObject?*o, Py_ssize_t?i)

刪除對象 o 的第 i 號元素。 失敗時返回 -1。 這相當于 Python 語句 del o[i]。

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

將序列對象 v 賦值給序列對象 o 的從 i1 到 i2 切片。 這相當于 Python 語句 o[i1:i2] = v。

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

刪除序列對象 o 的從 i1 到 i2 的切片。 失敗時返回 -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.

返回一個列表對象，其內容與序列或可迭代對象 o 相同，失敗時返回 NULL。 返回的列表保證是一個新對象。 這等價于 Python 表達式 list(o)。

PyObject* PySequence_Tuple(PyObject?*o)

Return value: New reference.

返回一個元組對象，其內容與序列或可迭代對象 o 相同，失敗時返回 NULL。 如果 o 為元組，則將返回一個新的引用，在其他情況下將使用適當的內容構造一個元組。 這等價于 Python 表達式 tuple(o)。

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

Return value: New reference.

將序列或可迭代對象 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)

Return value: Borrowed reference.

在 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)

Return value: New reference.

返回 o 的第 i 個元素或在失敗時返回 NULL。 此形式比 PySequence_GetItem() 理饌，但不會檢查 o 上的 PySequence_Check() 是否為真值，也不會對負序號進行調整。