Operator Type:
Operator Scope of Action:
Operator Purpose:
Operator First Added:
Operator Altered:
Function [other Function type actions]
List [operators of similar scope]
Query Boolean [other Query Boolean operators]
Baseline
List/Set.any(element, expression)
This is true if any element in the list matches the expression.
$MyBoolean = $MyList.any(x,x>5)
is true if any element in $MyList is greater than 5.
The comparison may also be applied to literal lists:
"apple; pear; plum".any(x, x=="plum")
is true because every element follows "aardvark" in alphabetical order.
If the target list or set is empty, .any() always returns false, and .every() always returns true.
The element is a user-set case-sensitive string. "x", "anItem", etc., are equally applicable. Similar to a loop variable in .each(x){}, the point of the element value, is to set a reference variable for each list element. This can then be used in the code provided by the expression parameter. Using a number for element, e.g. '1' or '42' is not recommended. Choose a value that makes sense for your own style of work
The expression is any action code expression that is a test resolving to a Boolean true/false answer.
For example, to test if any item exactly matches the value stored in the $MyString of 'Some note':
$MyBoolean = $MyList.any(anItem, anItem == $MyString("Some Note")
Or, any list value that starts with the string 'Large':
$MyBoolean = $MyList.any(Z, Z.contains("^ large")