列表对象

type PyListObject

此子类型的 PyObject represents a Python list object.

PyTypeObject PyList_Type
属于 稳定 ABI (应用程序二进制接口) .

此实例的 PyTypeObject represents the Python list type. This is the same object as list 在 Python 层。

int PyList_Check ( PyObject * p )

返回 True 若 p is a list object or an instance of a subtype of the list type. This function always succeeds.

int PyList_CheckExact ( PyObject * p )

返回 True 若 p is a list object, but not an instance of a subtype of the list type. This function always succeeds.

PyObject * PyList_New ( Py_ssize_t len )
返回值:新引用。 属于 稳定 ABI (应用程序二进制接口) .

Return a new list of length len 当成功时,或 NULL 当故障时。

注意

len is greater than zero, the returned list object’s items are set to NULL . Thus you cannot use abstract API functions such as PySequence_SetItem() or expose the object to Python code before setting all items to a real object with PyList_SetItem() .

Py_ssize_t PyList_Size ( PyObject * list )
属于 稳定 ABI (应用程序二进制接口) .

Return the length of the list object in list ; this is equivalent to len(list) on a list object.

Py_ssize_t PyList_GET_SIZE ( PyObject * list )

类似于 PyList_Size() , but without error checking.

PyObject * PyList_GetItem ( PyObject * list , Py_ssize_t index )
返回值:借位引用。 属于 稳定 ABI (应用程序二进制接口) .

Return the object at position index in the list pointed to by list . The position must be non-negative; indexing from the end of the list is not supported. If index is out of bounds (<0 or >=len(list)), return NULL and set an IndexError 异常。

PyObject * PyList_GET_ITEM ( PyObject * list , Py_ssize_t i )
返回值:借位引用。

类似于 PyList_GetItem() , but without error checking.

int PyList_SetItem ( PyObject * list , Py_ssize_t index , PyObject * item )
属于 稳定 ABI (应用程序二进制接口) .

Set the item at index index in list to item 。返回 0 on success. If index is out of bounds, return -1 and set an IndexError 异常。

注意

This function “steals” a reference to item and discards a reference to an item already in the list at the affected position.

void PyList_SET_ITEM ( PyObject * list , Py_ssize_t i , PyObject * o )

Macro form of PyList_SetItem() without error checking. This is normally only used to fill in new lists where there is no previous content.

注意

This macro “steals” a reference to item , and, unlike PyList_SetItem() , does not discard a reference to any item that is being replaced; any reference in list 在位置 i will be leaked.

int PyList_Insert ( PyObject * list , Py_ssize_t index , PyObject * item )
属于 稳定 ABI (应用程序二进制接口) .

Insert the item item into list list in front of index index 。返回 0 if successful; return -1 and set an exception if unsuccessful. Analogous to list.insert(index, item) .

int PyList_Append ( PyObject * list , PyObject * item )
属于 稳定 ABI (应用程序二进制接口) .

Append the object item at the end of list list 。返回 0 if successful; return -1 and set an exception if unsuccessful. Analogous to list.append(item) .

PyObject * PyList_GetSlice ( PyObject * list , Py_ssize_t low , Py_ssize_t high )
返回值:新引用。 属于 稳定 ABI (应用程序二进制接口) .

Return a list of the objects in list containing the objects between low and high 。返回 NULL and set an exception if unsuccessful. Analogous to list[low:high] . Indexing from the end of the list is not supported.

int PyList_SetSlice ( PyObject * list , Py_ssize_t low , Py_ssize_t high , PyObject * itemlist )
属于 稳定 ABI (应用程序二进制接口) .

Set the slice of list between low and high to the contents of itemlist . Analogous to list[low:high] = itemlist itemlist 可以是 NULL , indicating the assignment of an empty list (slice deletion). Return 0 当成功时, -1 on failure. Indexing from the end of the list is not supported.

int PyList_Sort ( PyObject * list )
属于 稳定 ABI (应用程序二进制接口) .

Sort the items of list in place. Return 0 当成功时, -1 on failure. This is equivalent to list.sort() .

int PyList_Reverse ( PyObject * list )
属于 稳定 ABI (应用程序二进制接口) .

Reverse the items of list in place. Return 0 当成功时, -1 on failure. This is the equivalent of list.reverse() .

PyObject * PyList_AsTuple ( PyObject * list )
返回值:新引用。 属于 稳定 ABI (应用程序二进制接口) .

Return a new tuple object containing the contents of list ; equivalent to tuple(list) .

上一话题

元组对象

下一话题

字典对象

本页