06. Lists | Talos

A list is a dynamic collection of values of the same type. Lists can be constructed using brackets [], and has a type signature of List[T]. To have a dynamic list of any-typing, the List type signature can be used.

// Create a list (type signature is superfluous)
let list: List[Number] = [1, 2, 3, 4, 5];

// Indexing starts at 0
Debug.println("First element of list is: {}", list.get(0));
Debug.println("Last element of list is: {}", list.get(-1));

// Out-of-bounds indexing will cause a panic to occur
// Debug.println("{}", list.get(5));

// `length` returns the total size of the list
Debug.println("Number of elements in list: {}", list.length());

// Can use the safe-access method `at` which returns an optional value.
for List.range(list.length() + 1) as (ii: Number) {
    let value = list.at(ii); // get the current value safely
    if (value.empty()) Debug.println("{}: {}", ii, value.unwrap());
    else if (value.some()) Debug.println("Exceeded list length!");
}