list

Report an issue View source Nightly · 7.4 . 7.3 · 7.2 · 7.1 · 7.0 · 6.5

The built-in list type. Example list expressions:

x = [1, 2, 3]

Accessing elements is possible using indexing (starts from 0):

e = x[1]   # e == 2

Lists support the + operator to concatenate two lists. Example:

x = [1, 2] + [3, 4]   # x == [1, 2, 3, 4]
x = ["a", "b"]
x += ["c"]            # x == ["a", "b", "c"]

Similar to strings, lists support slice operations:

['a', 'b', 'c', 'd'][1:3]   # ['b', 'c']
['a', 'b', 'c', 'd'][::2]  # ['a', 'c']
['a', 'b', 'c', 'd'][3:0:-1]  # ['d', 'c', 'b']

Lists are mutable, as in Python.

Members

None list.append(item)

Adds an item to the end of the list.

Parameter	Description
`item`	required Item to add at the end.

None list.clear()

Removes all the elements of the list.

None list.extend(items)

Adds all items to the end of the list.

Parameter	Description
`items`	required Items to add at the end.

int list.index(x, start=None, end=None)

Returns the index in the list of the first item whose value is x. It is an error if there is no such item.

Parameter	Description
`x`	required The object to search.
`start`	int; or `None`; default is `None` The start index of the list portion to inspect.
`end`	int; or `None`; default is `None` The end index of the list portion to inspect.

None list.insert(index, item)

Inserts an item at a given position.

Parameter	Description
`index`	int; required The index of the given position.
`item`	required The item.

unknown list.pop(i=-1)

Removes the item at the given position in the list, and returns it. If no index is specified, it removes and returns the last item in the list.

Parameter	Description
`i`	int; or `None`; default is `-1` The index of the item.

None list.remove(x)

Removes the first item from the list whose value is x. It is an error if there is no such item.

Parameter	Description
`x`	required The object to remove.