序列協(xié)議

int PySequence_Check(PyObject?*o)

如果對(duì)象提供序列協(xié)議，函數(shù)返回 1，否則返回 0。 請(qǐng)注意它將為具有 __getitem__() 方法的 Python 類返回 1，除非它們是 dict 的子類，因?yàn)樵谝话闱闆r下無法確定它所支持鍵類型。 此函數(shù)總是會(huì)成功執(zhí)行。

Py_ssize_t PySequence_Size(PyObject?*o)

Py_ssize_t PySequence_Length(PyObject?*o)

成功時(shí)返回序列中*o*的對(duì)象數(shù),失敗時(shí)返回``-1``. 相當(dāng)于Python的``len(o)``表達(dá)式.

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

Return value: New reference.

成功時(shí)返回 o1 和 o2 的拼接，失敗時(shí)返回 NULL。 這等價(jià)于 Python 表達(dá)式 o1 + o2。

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

Return value: New reference.

返回序列對(duì)象 o 重復(fù) count 次的結(jié)果，失敗時(shí)返回 NULL。 這等價(jià)于 Python 表達(dá)式 o * count。

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

Return value: New reference.

成功時(shí)返回 o1 和 o2 的拼接，失敗時(shí)返回 NULL。 在 o1 支持的情況下操作將 原地 完成。 這等價(jià)于 Python 表達(dá)式 o1 += o2。

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

Return value: New reference.

Return the result of repeating sequence object返回序列對(duì)象 o 重復(fù) count 次的結(jié)果，失敗時(shí)返回 NULL。 在 o 支持的情況下該操作會(huì) 原地 完成。 這等價(jià)于 Python 表達(dá)式 o *= count。

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

Return value: New reference.

返回 o 中的第 i 號(hào)元素，失敗時(shí)返回 NULL。 這等價(jià)于 Python 表達(dá)式 o[i]。

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

Return value: New reference.

返回序列對(duì)象 o 的 i1 到 i2 的切片，失敗時(shí)返回 NULL。 這等價(jià)于 Python 表達(dá)式 o[i1:i2]。

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

將對(duì)象 v 賦值給 o 的第 i 號(hào)元素。 失敗時(shí)會(huì)引發(fā)異常并返回 -1；成功時(shí)返回 0。 這相當(dāng)于 Python 語句 o[i] = v。 此函數(shù) 不會(huì) 改變對(duì) v 的引用。

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

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

刪除對(duì)象 o 的第 i 號(hào)元素。 失敗時(shí)返回 -1。 這相當(dāng)于 Python 語句 del o[i]。

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

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

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

刪除序列對(duì)象 o 的從 i1 到 i2 的切片。 失敗時(shí)返回 -1。 這相當(dāng)于 Python 語句 del o[i1:i2]。

Py_ssize_t PySequence_Count(PyObject?*o, PyObject?*value)

返回 value 在 o 中出現(xiàn)的次數(shù)，即返回使得 o[key] == value 的鍵的數(shù)量。 失敗時(shí)返回 -1。 這相當(dāng)于 Python 表達(dá)式 o.count(value)。

int PySequence_Contains(PyObject?*o, PyObject?*value)

確定 o 是否包含 value。 如果 o 中的某一項(xiàng)等于 value，則返回 1，否則返回 0。 出錯(cuò)時(shí)，返回 -1。 這相當(dāng)于 Python 表達(dá)式 value in o。

Py_ssize_t PySequence_Index(PyObject?*o, PyObject?*value)

返回第一個(gè)索引*i*,其中 o[i] == value.出錯(cuò)時(shí),返回 -1.相當(dāng)于Python的``o.index(value)``表達(dá)式.

PyObject* PySequence_List(PyObject?*o)

Return value: New reference.

返回一個(gè)列表對(duì)象，其內(nèi)容與序列或可迭代對(duì)象 o 相同，失敗時(shí)返回 NULL。 返回的列表保證是一個(gè)新對(duì)象。 這等價(jià)于 Python 表達(dá)式 list(o)。

PyObject* PySequence_Tuple(PyObject?*o)

Return value: New reference.

返回一個(gè)元組對(duì)象，其內(nèi)容與序列或可迭代對(duì)象 o 相同，失敗時(shí)返回 NULL。 如果 o 為元組，則將返回一個(gè)新的引用，在其他情況下將使用適當(dāng)?shù)膬?nèi)容構(gòu)造一個(gè)元組。 這等價(jià)于 Python 表達(dá)式 tuple(o)。

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

Return value: New reference.

將序列或可迭代對(duì)象 o 作為其他 PySequence_Fast* 函數(shù)族可用的對(duì)象返回。 如果該對(duì)象不是序列或可迭代對(duì)象，則會(huì)引發(fā) TypeError 并將 m 作為消息文本。 失敗時(shí)返回 NULL。

PySequence_Fast* 函數(shù)之所以這樣命名，是因?yàn)樗鼈儠?huì)假定 o 是一個(gè) PyTupleObject 或 PyListObject 并直接訪問 o 的數(shù)據(jù)字段。

作為 CPython 的實(shí)現(xiàn)細(xì)節(jié)，如果 o 已經(jīng)是一個(gè)序列或列表，它將被直接返回。

Py_ssize_t PySequence_Fast_GET_SIZE(PyObject?*o)

在 o 由 PySequence_Fast() 返回且 o 不為 NULL 的情況下返回 o 的長(zhǎng)度。 也可以通過在 o 上調(diào)用 PySequence_Size() 來獲取大小，但是 PySequence_Fast_GET_SIZE() 速度更快，因?yàn)樗梢约俣?o 為列表或元組。

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

Return value: Borrowed reference.

在 o 由 PySequence_Fast() 返回且 o 不 NULL，并且 i d在索引范圍內(nèi)的情況下返回 o 的第 i 號(hào)元素。

PyObject** PySequence_Fast_ITEMS(PyObject?*o)

返回 PyObject 指針的底層數(shù)組。 假設(shè) o 由 PySequence_Fast() 返回且 o 不為 NULL。

請(qǐng)注意,如果列表調(diào)整大小,重新分配可能會(huì)重新定位items數(shù)組.因此,僅在序列無法更改的上下文中使用基礎(chǔ)數(shù)組指針.

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

Return value: New reference.

返回 o 的第 i 個(gè)元素或在失敗時(shí)返回 NULL。 此形式比 PySequence_GetItem() 理饌，但不會(huì)檢查 o 上的 PySequence_Check() 是否為真值，也不會(huì)對(duì)負(fù)序號(hào)進(jìn)行調(diào)整。