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 == 2Lists 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 = NoneThe start index of the list portion to inspect. |
end
|
int; or None ;
default = NoneThe 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 = -1The 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. |