|List| -> List
Clears the list by removing all of its elements, and returns the cleared list.
x = [1, 2, 3]
x.clear()
|List, Value| -> Bool
Returns true if the list contains a value that matches the input value.
Matching is performed with the == equality operator.
[1, 'hello', (99, -1)].contains 'hello'
|List, Iterable| -> List
Extends the list with the output of the iterator, and returns the list.
x = [1, 2, 3]
x.extend 'abc'
x.last()
x.extend [10, 20, 30]
x.last()
|List, Value| -> List
Fills the list with copies of the provided value, and returns the list.
x = [1, 2, 3]
x.fill 99
x
|List| -> Value
Returns the first value in the list, or Null if the list is empty.
[99, -1, 42].first()
[].first()
|List, Number| -> Value
|List, Number, Value| -> Value
Gets the Nth value in the list.
If the list doesn't contain a value at that position then the provided default
value is returned. If no default value is provided then Null is returned.
x = [99, -1, 42]
x.get 1
x.get -1
x.get 5, 123
|List, Number, Value| -> List
Inserts the value into the Nth position in the list, and returns the list.
An error is thrown if the position is negative or greater than the size of the
list.
x = [99, -1, 42]
x.insert 2, 'hello'
x
|List| -> Bool
Returns true if the list has a size of zero, and false otherwise.
[].is_empty()
[1, 2, 3].is_empty()
|List| -> Value
Returns the last value in the list, or Null if the list is empty.
[99, -1, 42].last()
[].last()
|List| -> Value
Removes the last value from the list and returns it.
If the list is empty then Null is returned.
x = [99, -1, 42]
x.pop()
x
[].pop()
|List, Value| -> Value
Adds the value to the end of the list, and returns the list.
x = [99, -1]
x.push 'hello'
x
|List, Number| -> Value
Removes the value at the given position from the list and returns it.
Throws an error if the position isn't a valid index in the list.
[99, -1, 42].remove 1
|List, Number| -> List
|List, Number, Value| -> List
Grows or shrinks the list to the specified size, and returns the list.
If the new size is larger, then copies of the provided value (or Null if no
value is provided) are used to fill the new space.
x = [1, 2]
x.resize 4, 'x'
x.resize 3
x.resize 4
|List, Number, || -> Value| -> List
Grows or shrinks the list to the specified size, and returns the list.
If the new size is larger, then the provided function will be called repeatedly
to fill the remaining space, with the result of the function being added to the
end of the list.
new_entries = (5, 6, 7, 8).iter()
x = [1, 2]
x.resize_with 4, || new_entries.next().get()
x.resize_with 2, || new_entries.next().get()
|List, Value| -> List
Retains matching values in the list (discarding values that don't match), and
returns the list.
If the test value is a function, then the function will be called with each of
the list's values, and if the function returns true then the value will be
retained, otherwise if the function returns false then the value will be
discarded.
If the test value is not a function, then the list's values will be compared
using the == equality operator, and then retained if they match.
x = (1..10).to_list()
x.retain |n| n < 5
x
x = [1, 3, 8, 3, 9, -1]
x.retain 3
x
|List| -> List
Reverses the order of the list's contents, and returns the list.
x = ['hello', -1, 99, 'world']
x.reverse()
x
|List| -> List
Sorts the list in place, and returns the list.
|List, |Value| -> Value| -> List
Sorts the list in place, based on the output of calling a 'key' function for
each value, and returns the list. The function result is cached, so it's only
called once per value.
x = [1, -1, 99, 42]
x.sort()
x
x = ['bb', 'ccc', 'a']
x.sort size
x
x = [2, 1, 3]
x.sort |n| -n
x
|List, List| -> Null
Swaps the contents of the two input lists.
x = [1, 2, 3]
y = [7, 8, 9]
x.swap y
x
y
|List| -> Tuple
Returns a copy of the list data as a tuple.
[1, 2, 3].to_tuple()
|List, |Value| -> Value| -> List
Transforms the list data by replacing each value with the result of calling the
provided function, and then returns the list.
x = ['aaa', 'bb', 'c']
x.transform size
x
x.transform |n| '{n}!'
x