python (3.12.0)
1 /* List object interface
2
3 Another generally useful object type is a list of object pointers.
4 This is a mutable type: the list items can be changed, and items can be
5 added or removed. Out-of-range indices or non-list objects are ignored.
6
7 WARNING: PyList_SetItem does not increment the new item's reference count,
8 but does decrement the reference count of the item it replaces, if not nil.
9 It does *decrement* the reference count if it is *not* inserted in the list.
10 Similarly, PyList_GetItem does not increment the returned item's reference
11 count.
12 */
13
14 #ifndef Py_LISTOBJECT_H
15 #define Py_LISTOBJECT_H
16 #ifdef __cplusplus
17 extern "C" {
18 #endif
19
20 PyAPI_DATA(PyTypeObject) PyList_Type;
21 PyAPI_DATA(PyTypeObject) PyListIter_Type;
22 PyAPI_DATA(PyTypeObject) PyListRevIter_Type;
23
24 #define PyList_Check(op) \
25 PyType_FastSubclass(Py_TYPE(op), Py_TPFLAGS_LIST_SUBCLASS)
26 #define PyList_CheckExact(op) Py_IS_TYPE((op), &PyList_Type)
27
28 PyAPI_FUNC(PyObject *) PyList_New(Py_ssize_t size);
29 PyAPI_FUNC(Py_ssize_t) PyList_Size(PyObject *);
30
31 PyAPI_FUNC(PyObject *) PyList_GetItem(PyObject *, Py_ssize_t);
32 PyAPI_FUNC(int) PyList_SetItem(PyObject *, Py_ssize_t, PyObject *);
33 PyAPI_FUNC(int) PyList_Insert(PyObject *, Py_ssize_t, PyObject *);
34 PyAPI_FUNC(int) PyList_Append(PyObject *, PyObject *);
35
36 PyAPI_FUNC(PyObject *) PyList_GetSlice(PyObject *, Py_ssize_t, Py_ssize_t);
37 PyAPI_FUNC(int) PyList_SetSlice(PyObject *, Py_ssize_t, Py_ssize_t, PyObject *);
38
39 PyAPI_FUNC(int) PyList_Sort(PyObject *);
40 PyAPI_FUNC(int) PyList_Reverse(PyObject *);
41 PyAPI_FUNC(PyObject *) PyList_AsTuple(PyObject *);
42
43 #ifndef Py_LIMITED_API
44 # define Py_CPYTHON_LISTOBJECT_H
45 # include "cpython/listobject.h"
46 # undef Py_CPYTHON_LISTOBJECT_H
47 #endif
48
49 #ifdef __cplusplus
50 }
51 #endif
52 #endif /* !Py_LISTOBJECT_H */
Browse
Usage
Versions