All nested arrays are immutable and thus tuples.
list = [];
list.push(['this list will be nested and therefore convert to a tuple']);
// Check that the first item in `list` is indeed a `tuple`
assert(is_tuple(list[0]));
// Check that the `tuple` is indeed immutable
assert(is_err(try(list[0].push('cannot be added to a tuple'))));
A tuple only becomes a tuple when it is nested inside another tuple or list, which means the tuple will be immutable.
| Function | Description |
|---|---|
| choice | Return a random item from a tuple. |
| copy | Copy a tuple (same as dup unless a non-zero deep argument is used). |
| count | Returns the number of elements with a specified value in a tuple. |
| dup | Duplicate a tuple. |
| each | Iterate over all items in a tuple. |
| every | Check if all items pass a given test. |
| filter | Return a new list with items that pass a given test. |
| find | Return the first item that pass a given test. |
| find_index | Return the index of the first item that pass a given test. |
| first | Return the first item from a tuple. |
| flat | Return a new list with all tuple elements concatenated into it recursively up to a specified depth. |
| has | Return true if a given value is found in the tuple, or false if not found. |
| index_of | Return the index of a given value, or nil if not found. |
| is_unique | Returns true if each item in a tuple is unique or false if a duplicate is found. |
| join | Returns a string with all items joined. |
| last | Return the last item from a tuple. |
| len | Return the length of the tuple. |
| map | Return a new list with the results of calling a provided closure on every item. |
| map_id | Return a new list with the Ids for all the things in the original list. |
| map_type | Return a new list with each item of the original list converted to a typed-thing of the given Type. |
| map_wrap | Return a new list with the Ids for all the things in the original list. |
| reduce | Execute a reducer function on each item, resulting in a single output value. |
| reverse | Return a new list with the items in reverse order. |
| some | Check if at least one item passes a given test. |
| sort | Return a new sorted list. |
| sum | Returns the sum of all elements in a tuple. |
| unique | Returns a new list without duplicate items. |
The above functions correspond to those of a list. For that reason, they are only listed under the data type list.