List（串列）物件¶
-
PyTypeObject PyList_Type¶
- 為 穩定 ABI 的一部分.
此
PyTypeObject實例表示 Python 的 list 型別。這與 Python 層中的list是同一個物件。
-
int PyList_Check(PyObject *p)¶
- Thread safety: Atomic.
如果 p 是一個 list 物件或者是 list 型別之子型別的實例，就回傳 true。這個函式永遠會成功執行。
-
int PyList_CheckExact(PyObject *p)¶
- Thread safety: Atomic.
如果 p 是一個 list 物件但不是 list 型別的子型別的實例，就回傳 true。這個函式永遠會成功執行。
-
PyObject *PyList_New(Py_ssize_t len)¶
- 回傳值：新的參照。 為 穩定 ABI 的一部分. Thread safety: Atomic.
成功時回傳長度為 len 的新串列，失敗時回傳
NULL。備註
如果 len 大於零，則回傳的串列物件之項目將被設定為
NULL。因此，在使用PyList_SetItem()或PyList_SET_ITEM()來將所有項目設定為一個真實物件前，你無法使用像是PySequence_SetItem()的抽象 API 函式，也不能將物件暴露 (expose) 給 Python 程式碼。以下 API 在串列完全初始化之前是安全的：PyList_SetItem()和PyList_SET_ITEM()。
-
Py_ssize_t PyList_Size(PyObject *list)¶
- 為 穩定 ABI 的一部分. Thread safety: Atomic.
回傳 list 串列物件的長度；這相當於串列物件的
len(list)。
-
Py_ssize_t PyList_GET_SIZE(PyObject *list)¶
- Thread safety: Atomic.
與
PyList_Size()類似，但沒有錯誤檢查。
-
PyObject *PyList_GetItemRef(PyObject *list, Py_ssize_t index)¶
- 回傳值：新的參照。 為 穩定 ABI 的一部分 自 3.13 版本開始. Thread safety: Atomic.
回傳 list 指向的串列中位於 index 位置的物件。該位置不可為負數；並不支援從串列尾末開始索引。如果 index 超出邊界範圍 (
<0 or >=len(list)) 則回傳NULL並設定IndexError例外。在 3.13 版被加入.
-
PyObject *PyList_GetItem(PyObject *list, Py_ssize_t index)¶
- 回傳值：借用參照。 為 穩定 ABI 的一部分. Thread safety: