An ordered collection you can create, read, loop through, destructure, and update while the script runs.
list(iterable=(), /)numbers = list()
numbers.append(2)
numbers.extend([0, 3])
first = numbers[0] # returns 2
count = len(numbers) # returns 3
for value in numbers:
wait(50) # returns NoneCreate an empty list or copy the items from one iterable into a new mutable list.
list()
list(iterable, /)| Name | Description |
|---|---|
iterableIterable | Source values to copy into the new list. Depends on overload · Positional only Default: () |
numbers = list()
numbers.append(2)
numbers.append(3)
copied = list(numbers)Create a list literal inline. This is the shortest form when you already know the items.
[1, 2, 3]| Name | Description |
|---|---|
itemAny? | Each item written inside the brackets. Required · Positional or named No default |
numbers = [2, 0, 3]
first = numbers[0] # returns 2Build a list by looping through another iterable. Multiple for/if clauses are supported, and loop targets stay local to the comprehension.
[expr for target in iterable if condition]| Name | Description |
|---|---|
exprAny? | Value to append for each accepted item. Required · Positional or named No default |
targetName | destructuring target | Loop target for the current item. Starred targets are not supported. Required · Positional or named No default |
iterableIterable | Source values to loop through. Required · Positional or named No default |
conditionBoolean | Optional filter checked before appending. Optional · Positional only Default: True |
values = [1, 2, 3, 4]
evens = [x for x in values if x % 2 == 0]Create a new integer list for loops, counters, and numeric ranges.
range(stop, /) | range(start, stop, step=1, /)| Name | Description |
|---|---|
startNumber | Start value (inclusive). Depends on overload · Positional only Default: 0 |
stopNumber | End value (exclusive). Required · Positional only No default |
stepNumber | Increment between items. Cannot be 0. Depends on overload · Positional only Default: 1 |
numbers = range(5) # returns [0, 1, 2, 3, 4]
evens = range(0, 10, 2) # returns [0, 2, 4, 6, 8]Count how many items are in the list.
len(list, /)Int — Number of items in the list.numbers = range(3, 8) # returns [3, 4, 5, 6, 7]
count = len(numbers) # returns 5Read one item by index. Negative indexes count from the end.
list[index]Any? — The item at that position. Raises IndexError when the index is outside the list.numbers = range(10, 15) # returns [10, 11, 12, 13, 14]
first = numbers[0] # returns 10
third = numbers[2] # returns 12
last = numbers[-1] # returns 14Copy part of a list using Python-style slicing. Omitted bounds use the start or end; negative indexes count from the end.
list[start:end[:step]]numbers = [0, 1, 2, 3, 4]
middle = numbers[1:4] # returns [1, 2, 3]
tail = numbers[-2:] # returns [3, 4]
reverse = numbers[::-1] # returns [4, 3, 2, 1, 0]Replace one existing item by index. Negative indexes count from the end. The index must already be inside the list.
list[index] = valueNone — No direct return value. The list is updated in place.numbers = [12, 12, 21, 3, 2, 1]
numbers[4] = 3 # numbers becomes [12, 12, 21, 3, 3, 1]Unpack list items into matching assignment targets. Nested targets are supported, but starred targets such as *rest are not supported.
a, b = listNone — No direct return value. Targets receive list items left to right.point = [500, 900]
x, y = pointAdd one new item to the end of the list.
list.append(value, /)| Name | Description |
|---|---|
valueAny? | The value to add. Required · Positional only No default |
None — No direct return value. The list is updated in place.numbers = [2, 0]
numbers.append(3)
last = numbers[-1] # returns 3Append every item from another iterable to the end of the current list.
list.extend(iterable, /)| Name | Description |
|---|---|
iterableIterable | Source values whose items will be appended. Required · Positional only No default |
None — No direct return value. The list grows in place.numbers = [1]
numbers.extend([2, 3])
count = len(numbers) # returns 3Insert one item before the given index. Negative and oversized indexes are clamped like Python.
list.insert(index, value, /)| Name | Description |
|---|---|
indexInt | Position before which the value is inserted. Required · Positional only No default |
valueAny? | The value to insert. Required · Positional only No default |
None — No direct return value. The list is updated in place.numbers = [1, 3]
numbers.insert(1, 2) # numbers becomes [1, 2, 3]Remove the first item whose value matches the given value.
list.remove(value, /)| Name | Description |
|---|---|
valueAny? | Value to find and remove from the list. Required · Positional only No default |
None — No direct return value. Raises ValueError when the value is not found.numbers = [1, 2, 2, 3]
numbers.remove(2) # numbers becomes [1, 2, 3]Remove one item from the list and return it. Omitting the index removes the last item.
list.pop(index=-1, /)| Name | Description |
|---|---|
indexInt | Optional index to remove. Negative indexes count from the end. Optional · Positional only Default: -1 |
numbers = [2, 0, 3]
removed = numbers.pop() # returns 3
first = numbers.pop(0) # returns 2Remove every item from the list.
list.clear()None — No direct return value. The list becomes empty.numbers = [2, 0, 3]
numbers.clear()
text(str(len(numbers))) # returns 0Return the first index whose item equals value within the optional start and stop bounds.
list.index(value, start=0, stop=len(list), /)| Name | Description |
|---|---|
valueAny? | Value to search for. Required · Positional only No default |
startInt | Optional start bound. Negative values count from the end. Optional · Positional only Default: 0 |
stopInt | Optional stop bound. The item at this index is not included. Optional · Positional only Default: len(list) |
Int — The matching index. Raises ValueError when the value is not found.numbers = [1, 2, 1, 3]
first_one = numbers.index(1) # returns 0
later_one = numbers.index(1, 1) # returns 2Count how many items equal the given value.
list.count(value, /)| Name | Description |
|---|---|
valueAny? | Value to count. Required · Positional only No default |
Int — Number of matching items.numbers = [1, 2, 1, 3]
ones = numbers.count(1) # returns 2Sort the list in place using the same stable ordering rules as sorted().
list.sort(*, key=None, reverse=False)| Name | Description |
|---|---|
keyCallable? | Optional function that returns the comparison key for each item. Optional · Keyword only Default: None |
reverseBoolean | When true, sort from largest to smallest. Optional · Keyword only Default: False |
None — No direct return value. The list is reordered in place.numbers = [3, 1, 2]
numbers.sort()
text(str(numbers)) # returns [1, 2, 3]Reverse the list in place.
list.reverse()None — No direct return value. The list order is reversed in place.numbers = [1, 2, 3]
numbers.reverse() # numbers becomes [3, 2, 1]Create a shallow mutable copy of the list.
list.copy()numbers = [1, 2]
copied = numbers.copy()
copied.append(3)
count = len(numbers) # returns 2Loop through items in order from left to right.
for item in list:None — No direct return value. The loop runs its body once per item.steps = range(1, 4) # returns [1, 2, 3]
for step in steps:
wait(step * 100) # returns NoneCheck whether the list has at least one item. An empty list is treated as false.
if list | if not listBoolean condition — true when the list is not empty, false when it is empty.numbers = range(0) # returns []
if not numbers:
text("No items") # returns None