IMPORTANT: The Bazel docs have moved! Please update your bookmark to https://bazel.build/rules/lib/list

You can read about the migration, and let us know what you think.

Extensions > API reference > list

list

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.

append

None list.append(item)

Adds an item to the end of the list.

Parameters

Parameter Description
item required
Item to add at the end.

clear

None list.clear()

Removes all the elements of the list.

extend

None list.extend(items)

Adds all items to the end of the list.

Parameters

Parameter Description
items required
Items to add at the end.

index

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.

Parameters

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

insert

None list.insert(index, item)

Inserts an item at a given position.

Parameters

Parameter Description
index required
The index of the given position.
item required
The item.

pop

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.

Parameters

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

remove

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.

Parameters

Parameter Description
x required
The object to remove.