7.2.3 List Objects
- PyListObject
-
This subtype of PyObject represents a Python list object.
- PyTypeObject PyList_Type
-
This instance of PyTypeObject represents the Python list type.
- int PyList_Check(PyObject *p)
-
Returns true if its argument is a PyListObject.
- PyObject* PyList_New(int size)
-
Returns a new list of length len on success, and NULL on
failure.
- int PyList_Size(PyObject *list)
-
Returns the length of the list object in list.
- PyObject* PyList_GetItem(PyObject *list, int index)
-
Returns the object at position pos in the list pointed
to by p. If pos is out of bounds, returns NULL and
sets an IndexError exception. Note: this
function returns a ``borrowed'' reference.
- int PyList_SetItem(PyObject *list, int index,
PyObject *item)
-
Sets the item at index index in list to item.
- int PyList_Insert(PyObject *list, int index,
PyObject *item)
-
Inserts the item item into list list in front of index
index. Returns 0 if successful; returns -1 and sets an
exception if unsuccessful. Analogous to list.insert(index, item).
- int PyList_Append(PyObject *list, PyObject *item)
-
Appends the object item at the end of list list. Returns
0 if successful; returns -1 and sets an exception if unsuccessful.
Analogous to list.append(item).
- PyObject* PyList_GetSlice(PyObject *list,
int low, int high)
-
Returns a list of the objects in list containing the objects
between low and high. Returns NULL and sets an
exception if unsuccessful.
Analogous to list[low:high].
- int PyList_SetSlice(PyObject *list,
int low, int high,
PyObject *itemlist)
-
Sets the slice of list between low and high to the contents
of itemlist. Analogous to list[low:high]=itemlist. Returns 0
on success, -1 on failure.
- int PyList_Sort(PyObject *list)
-
Sorts the items of list in place. Returns 0 on success, -1 on failure.
- int PyList_Reverse(PyObject *list)
-
Reverses the items of list in place. Returns 0 on success, -1 on failure.
- PyObject* PyList_AsTuple(PyObject *list)
-
Returns a new tuple object containing the contents of list.
- PyObject* PyList_GET_ITEM(PyObject *list, int i)
-
Macro form of PyList_GetItem() without error checking.
- PyObject* PyList_SET_ITEM(PyObject *list, int i,
PyObject *o)
-
Macro form of PyList_SetItem() without error checking.
- int PyList_GET_SIZE(PyObject *list)
-
Macro form of PyList_GetSize() without error checking.