| Operator Type: | Function |
| Operator Scope of Action: | Document |
| Operator Purpose: | List creation |
values(attribute)
New to v5.10.1, values() returns a Set of unique values for the attribute attribute. As the output is a of Set data type, the list of possible values is de-duped thus giving a list of unique values.
If the named attribute is a set or list, values() returns a list of all the unique discrete list item values that occur. If the named attribute is a string, values() returns all the unique strings.
The attribute parameter is evaluated so may be:
- A quoted attribute name without $-prefix:
values("MyString"). - An attribute name (whose current value is the name of an attribute. If $MyString holder the value "MyList", then
values($MyString)will evaluate the unique values for $MyList. - An expression resolving to an attribute name.
The scope of the assessment is always across the whole document. The data is returned in case-sensitive sort order (i.e. all capitals sort before lower case letters) so chaining .isort() may often be the desired 'default'.
values() differs from collect() in that values() returns Set-type data and collect() returns List-type data. The following are functionally equivalent in output:
$values($MyList)
collect("all",$MyList).unique
