列表對象?
-
PyTypeObject PyList_Type?
- Part of the Stable ABI.
這是個(gè)屬于
PyTypeObject的代表Python列表類型的實(shí)例。在Python層面和類型list是同一個(gè)對象。
-
int PyList_Check(PyObject *p)?
如果 p 是一個(gè) list 對象或者 list 類型的子類型的實(shí)例則返回真值。 此函數(shù)總是會(huì)成功執(zhí)行。
-
int PyList_CheckExact(PyObject *p)?
如果 p 是一個(gè) list 對象但不是 list 類型的子類型的實(shí)例則返回真值。 此函數(shù)總是會(huì)成功執(zhí)行。
-
PyObject *PyList_New(Py_ssize_t len)?
- Return value: New reference. Part of the Stable ABI.
成功時(shí)返回一個(gè)長度為 len 的新列表，失敗時(shí)返回
NULL。備注
當(dāng) len 大于零時(shí)，被返回的列表對象項(xiàng)目被設(shè)成
NULL。因此你不能用類似C函數(shù)PySequence_SetItem()的抽象API或者用C函數(shù)PyList_SetItem()將所有項(xiàng)目設(shè)置成真實(shí)對象前對Python代碼公開這個(gè)對象。
-
Py_ssize_t PyList_Size(PyObject *list)?
- Part of the Stable ABI.
返回 list 中列表對象的長度；這等于在列表對象調(diào)用
len(list)。
-
Py_ssize_t PyList_GET_SIZE(PyObject *list)?
Similar to
PyList_Size(), but without error checking.
-
PyObject *PyList_GetItem(PyObject *list, Py_ssize_t index)?
- Return value: Borrowed reference. Part of the Stable ABI.
返回 list 所指向列表中 index 位置上的對象。 位置值必須為非負(fù)數(shù)；不支持從列表末尾進(jìn)行索引。 如果 index 超出邊界 (<0 or >=len(list))，則返回
NULL并設(shè)置IndexError異常。
-
PyObject *PyList_GET_ITEM(PyObject *list, Py_ssize_t i)?
- Return value: Borrowed reference.
Similar to
PyList_GetItem(), but without error checking.
-
int PyList_SetItem(PyObject *list, Py_ssize_t index, PyObject *item)?
- Part of the Stable ABI.
將列表中索引為 index 的項(xiàng)設(shè)為 item。 成功時(shí)返回
0。 如果 index 超出范圍則返回-1并設(shè)定IndexError異常。備注
此函數(shù)會(huì)“偷走”一個(gè)對 item 的引用并丟棄一個(gè)對列表中受影響位置上的已有條目的引用。
-
void PyList_SET_ITEM(PyObject *list, Py_ssize_t i, PyObject *o)?
不帶錯(cuò)誤檢測的宏版本
PyList_SetItem()。 這通常只被用于新列表中之前沒有內(nèi)容的位置進(jìn)行填充。備注
該宏會(huì)“偷走”一個(gè)對 item 的引用，但與
PyList_SetItem()不同的是它 不會(huì) 丟棄對任何被替換條目的引用；在 list 的 i 位置上的任何引用都將被泄露。
-
int PyList_Insert(PyObject *list, Py_ssize_t index, PyObject *item)?
- Part of the Stable ABI.
將條目 item 插入到列表 list 索引號 index 之前的位置。 如果成功將返回
0；如果不成功則返回-1并設(shè)置一個(gè)異常。 相當(dāng)于list.insert(index, item)。
-
int PyList_Append(PyObject *list, PyObject *item)?
- Part of the Stable ABI.
將對象 item 添加到列表 list 的末尾。 如果成功將返回
0；如果不成功則返回-1并設(shè)置一個(gè)異常。 相當(dāng)于list.append(item)。
-
PyObject *PyList_GetSlice(PyObject *list, Py_ssize_t low, Py_ssize_t high)?
- Return value: New reference. Part of the Stable ABI.
返回一個(gè)對象列表，包含 list 當(dāng)中位于 low 和 high 之間 的對象。 如果不成功則返回
NULL并設(shè)置異常。 相當(dāng)于list[low:high]。 不支持從列表末尾進(jìn)行索引。
-
int PyList_SetSlice(PyObject *list, Py_ssize_t low, Py_ssize_t high, PyObject *itemlist)?
- Part of the Stable ABI.
將 list 當(dāng)中 low 與 high 之間的切片設(shè)為 itemlist 的內(nèi)容。 相當(dāng)于
list[low:high] = itemlist。 itemlist 可以為NULL，表示賦值為一個(gè)空列表（刪除切片）。 成功時(shí)返回0，失敗時(shí)返回-1。 這里不支持從列表末尾進(jìn)行索引。
-
int PyList_Sort(PyObject *list)?
- Part of the Stable ABI.
對 list 中的條目進(jìn)行原地排序。 成功時(shí)返回
0，失敗時(shí)返回-1。 這等價(jià)于list.sort()。
-
int PyList_Reverse(PyObject *list)?
- Part of the Stable ABI.
對 list 中的條目進(jìn)行原地反轉(zhuǎn)。 成功時(shí)返回
0，失敗時(shí)返回-1。 這等價(jià)于list.reverse()。
-
PyObject *PyList_AsTuple(PyObject *list)?
- Return value: New reference. Part of the Stable ABI.
返回一個(gè)新的元組對象，其中包含 list 的內(nèi)容；等價(jià)于
tuple(list)。