| Operator Type: | Function |
| Operator Scope of Action: | Item |
| Operator Purpose: | Data manipulation |
list(expression_list)
This function returns the evaluated format of each of its comma-delimited argument list. New to v5.10.0. Arguments can be:
- Literal values
Fred- though there's little point in these unless the list is subsequently to be concatenated to a String. - Basic literal operations
"Fred"+" " +Smith",. - Attributes
$Name,$MyNumber. - Action operators
sqrt(2). - Action code expressions. whole code expressions
"Date: "+date("today").format("*").
For example:
Code: list("This note 's $Width is "+$Width, "the $Xpos is "+$Xpos).format(" and ")+"!"
Value output: This note's $Width is 3 and the $Xpos is 36.5!
This example is not overly complex but points to how list() can be used in constructing output strings/lists that are otherwise difficult to create. The more complex the expressions passed to list() the greater the likelihood of geting no output - or an unexpected one. If complex inputs don't work consider using more parentheses to help TB figure the order of sub-task execution or else put the result of expressions into new attributes and then pass the value of the latter into list() as a parameter.
