Skip to content

Python List API

Python list 方法 —— 可变的有序序列,用于存储和操作集合。

1 class · 9 methods

list

9 methods

任意对象的可变有序序列。

list.append(item)

将 item 追加到列表末尾。

Parameters

NameTypeDescription
itemAny要追加的元素。

Returns

None

Example

python
nums = [1, 2]
nums.append(3)
# nums == [1, 2, 3]
list.extend(iterable)

通过追加 iterable 中的所有元素来扩展列表。

Parameters

NameTypeDescription
iterableIterable其元素将被追加的可迭代对象。

Returns

None

Example

python
nums = [1, 2]
nums.extend([3, 4])
# nums == [1, 2, 3, 4]
list.insert(index, item)

在给定索引之前插入 item。

Parameters

NameTypeDescription
indexint插入位置。
itemAny要插入的元素。

Returns

None

Example

python
nums = [1, 3]
nums.insert(1, 2)
# nums == [1, 2, 3]
list.remove(item)

移除首次出现的 item。未找到则抛出 ValueError。

Parameters

NameTypeDescription
itemAny要移除的元素。

Returns

None

Example

python
nums = [1, 2, 1]
nums.remove(1)
# nums == [2, 1]
list.pop([index])

移除并返回指定索引处的元素(默认为最后一个)。列表为空则抛出 IndexError。

Parameters

NameTypeDescription
indexint要移除元素的索引(默认 -1)。

Returns

Any

Example

python
nums = [1, 2, 3]
nums.pop()     # 3, nums == [1, 2]
nums.pop(0)    # 1, nums == [2]
list.sort(*, key=None, reverse=False)

就地排序列表。

Parameters

NameTypeDescription
keyCallable | None提取排序键的函数。
reversebool为 True 时降序排序。

Returns

None

Example

python
nums = [3, 1, 2]
nums.sort()
# nums == [1, 2, 3]

words = ['bb', 'a', 'ccc']
words.sort(key=len)
# words == ['a', 'bb', 'ccc']
list.reverse()

就地反转列表。

Returns

None

Example

python
nums = [1, 2, 3]
nums.reverse()
# nums == [3, 2, 1]
list.index(item[, start[, end]])

返回 item 首次出现的索引。未找到则抛出 ValueError。

Parameters

NameTypeDescription
itemAny要查找的元素。
startint起始索引。
endint结束索引。

Returns

int

Example

python
nums = [1, 2, 1]
nums.index(1)      # 0
nums.index(1, 1)   # 2
list.count(item)

返回 item 出现的次数。

Parameters

NameTypeDescription
itemAny要计数的元素。

Returns

int

Example

python
[1, 2, 1, 1].count(1)  # 3