List

List Operators

range from to

Generates a list of all numbers between from (inclusive) and to (exclusive). List elements can be integer or float types.

Equivalent to the (..) binary operator.

Example:

one_two_three = range 1 4
one_two_three = (..) 1 4
one_two_three = 1 .. 4

rangei from to

Returns a list of all numbers between from (inclusive) and to (inclusive). List elements can be integer or float types.

Equivalent to the (..=) binary operator.

Example:

one_two_three = rangei 1 3
one_two_three = (..=) 1 3
one_two_three = 1 ..= 3

concat x y

Returns a list of length 2 containing x as the first element and y as the second element. x and y must be of the same type.

Equivalent to the (++) binary operator.

Example:

one_two = concat 1 2
one_two = (++) 1 2
one_two = 1 ++ 2

prepend value list

Return a new list with value added to the start of list. value must be the same type as the elements of list.

Equivalent to the (+>) binary operator.

Example:

one_two_three = prepend 1 [2, 3]
one_two_three = (+>) 1 [2, 3]
one_two_three = 1 +> [2, 3]

append list value

Return a new list with value added to the end of list. value must be the same type as the elements of list.

Equivalent to the (<+) binary operator.

Example:

one_two_three = append [1, 2] 3
one_two_three = (<+) [1, 2] 3
one_two_three = [1, 2] <+ 3

Query Functions

nth index list

Returns the element at index of list. index must be of the integer type.

Example:

two = nth 1 [1, 2, 3]

length list

Returns the number of elements in list.

Example:

three = length [1, 2, 3]

is_empty list

Returns true if length of list is zero, false otherwise.

Example:

true_ = is_empty []

contains value list

Returns true if value is equal to an element in list, false otherwise.

Example:

true_ = contains 3 [1, 2, 3]

index_of value list

Returns the index of first element in list that is equal to value, -1 if not found.

Example:

one = index_of 2 [1, 2, 3, 2]

Modification Functions

set index value list

Returns a new list where element of list at index is replaced with value. index must be of the integer type and value must be the same type as elements of list.

Example:

one_two_three = set 1 2 [1, 3, 3]

head list

Returns the first element of list.

Example:

one = head [1, 2, 3]

tail list

Returns a new list containing all elements of list except the first one.

Example:

two_three = tail [1, 2, 3]

init list

Returns a new list containing all elements of list except the last one.

Example:

one_two = init [1, 2, 3]

last list

Returns the last element of list.

Example:

three = last [1, 2, 3]

take count list

Returns a new list containing the first count elements of list, or the last elements if count is negative. count must be of the integer type.

Example:

one_two_three = take 3 [1, 2, 3, 4, 5]
three_four_five = take -3 [1, 2, 3, 4, 5]

drop count list

Returns a new list excluding the first count elements of list, or the last elements if count is negative. count must be of the integer type.

Example:

three_four_five = drop 2 [1, 2, 3, 4, 5]
one_two_three = drop -2 [1, 2, 3, 4, 5]

slice start end list

Returns a new list containing elements from list between the start and end indices. start and end must be of the integer type.

Example:

two_three = slice 1 3 [1, 2, 3, 4, 5]

split index list

Divides list into two parts at index, returning a two-dimensional list containing the two resulting sublists. index must be of the integer type.

Example:

true_ = [[1, 2], [3, 4]] == split 2 [1, 2, 3, 4]

Transformation Functions

reverse list

Returns a new list with the elements of list in reverse order.

Example:

three_two_one = reverse [1, 2, 3]

unique list

Returns a new list containing only the distinct elements of list, removing duplicates.

Example:

one_two_three = unique [1, 2, 1, 2, 3, 3, 3]

sort list

Returns a new list with the elements of list sorted in ascending order.

Example:

one_two_three = sort [1, 3, 2]

flatten list

Returns a new list by concatenating all nested lists within list into a single, one-dimensional list.

Example:

one_two_three = flatten [[1, 2], [3]]

intersperse value list

Returns a new list with a specified value inserted between each element of list. value must be of the same type of the elements of list.

Example:

one_four_two_four_three = intersperse 4 [1, 2, 3]

Reduction Functions

min_of list

Returns the smallest element of list. Elements of list must be of the integer or float types.

Example:

one = min_of [2, 1, 3]

max_of list

Returns the largest element of list. Elements of list must be of the integer or float types.

Example:

three = max_of [1, 3, 2]

sum list

Returns the total sum of all elements in list. Elements of list must be of the integer, float, or complex types.

Example:

ten = sum [1, 2, 3, 4]

product list

Returns the total product of all elements in list. Elements of list must be of the integer, float, or complex types.

Example:

twenty_four = product [1, 2, 3, 4]