Name

list — Return a list of values.

Syntax

list(value, ...)
              

The LIST function has the following argument:

value

Zero or more values that make up the list.

Description

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.

Examples

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 integersList of integer
list(list('a','b'),list('c','d'))Return a list of lists of stringsList 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