Python: List Methods

By Xah Lee. Date: . Last updated: .

All list methods modifies the list in-place.

Append to List

note: you can also join lists by list1 + list2

list.append(x)
Append x to the end.
xx = [1, 2, 3]
xx.append("a")
print(xx == [1, 2, 3, "a"])
xx = [1, 2, 3]
xx.append(["a"])
print(xx == [1, 2, 3, ["a"]])
list.extend(x)
Append x to the end, but flatten x one level if its a list.
xx = [1, 2, 3]
xx.extend(["a"])
print(xx == [1, 2, 3, "a"])

Insert an Item

list.insert(i, x)
Insert at i. Same as list[i:i] = [x]
xx = [1, 2, 3]
xx.insert(1, "a")
print(xx == [1, "a", 2, 3])

Pop, Remove First Item

list.pop()
Remove last item and return that item.
list.pop(i)
Remove ith item and return that item.

Find Item

list.index(x)
Return the index of first occurrence of x. Error if x is not in list.
xx = [0, 1, 2, 3, 4, 5, 6, 9, 8, 9]
print(xx.index(3) == 3)
list.index(x, i)
Start at index i

Best to think of index as between items. The left of first item is 0.

xx = ["a", "b", "c"]
print(xx.index("b", 1) == 1)

# print(xx.index('b', 2))
# ValueError: 'b' is not in list
list.index(x, i, j)
search between index j and j
list.remove(x)
Remove first occurrence of x. return None. Error if x is not in list.
xx = [0, 1, 2, 3]
print(xx.remove(2) == None)
print(xx == [0, 1, 3])

Find and count

list.count(x)
Return the number of occurrences of x
print([1, 2, 3, 2, 7, 2].count(2) == 3)

Sort and Reverse

Python: Sort

Python Data Structure

Python

Overview

Help

Comment

String

Arithmetic

Boolean

Conditional

Loop

Data Structure

Function and Class

Module

Misc

Regex

Text Processing

Web

Misc