list
list(value
,...
)
The LIST function has the following argument:
value
Zero or more values that make up the list.
Return a list of values, to be used in functions that require a list of values as input.
Lists can contain any data type, but all values in the list must have the same data types. For example, a list cannot combine numbers and strings.
Nested lists are allowed, but all nested list elements must contain the same data types (e.g. all lists of strings).
Empty lists are allowed, but these must be wrapped in the aslist type hint in order to reveal the list data type to the expression compiler.
Lists can also be specified by a list of values surrounded by brace characters. This syntax has an identical outcome to using the list function.
Formula |
Description |
Result |
---|---|---|
list(1, 2, 3, 4, 5) | Return a list of integers. | List of integer |
{1, 2, 3, 4, 5} | Alternate syntax to return a list of integers, with identical result as the above line. | List of integers |
list(13.8, 7.6, 22.4) | Return a list of numbers. | List list of number |
list('a', 'b', 'c') | Return a list of strings. | List of string |
asList(list(),list(1)) | Return an empty list of integers | List of integer |
list(list('a','b'),list('c','d')) | Return a list of lists of strings | List of lists |
{{'a','b'},{'c','d'}} | Alternate syntax to return a list of lists of string, with identical result as the above line. | List of lists |