Tinderbox v9 Icon

List/Set.any(element, expression)

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]



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") 

A Tinderbox Reference File : Actions & Rules : Operators : Full Operator List : List/Set.any(element, expression)