此实例的
PyTypeObject
represents the Python list type. This is the same object as
list
在 Python 层。
返回 True 若 p is a list object or an instance of a subtype of the list type. This function always succeeds.
返回 True 若 p is a list object, but not an instance of a subtype of the list type. This function always succeeds.
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()
.
Return the length of the list object in
list
; this is equivalent to
len(list)
on a list object.
类似于
PyList_Size()
, but without error checking.
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
异常。
类似于
PyList_GetItem()
, but without error checking.
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.
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.
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)
.
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)
.
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.
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.
Sort the items of
list
in place. Return
0
当成功时,
-1
on failure. This is equivalent to
list.sort()
.
Reverse the items of
list
in place. Return
0
当成功时,
-1
on failure. This is the equivalent of
list.reverse()
.
Return a new tuple object containing the contents of
list
; equivalent to
tuple(list)
.