find(query)

Tinderbox Icon


Operator Type:   Function
Operator Scope of Action:   Query
Operator Purpose:   List creation

find(query)

Added in v5.6.0, the find() operator returns list-type data of the $Path of all items matching query.

Conceptually find() is intended for where no item or group designator exists for use inline in action code. In most cases an agent is the likely and better alternative, noting that agents can also use the results of other agents. find() can also be thought of as a short way of writing:

collect_if(all, expression, $Path) 

where the expression is query.


Possible relevant notes (via "Similar Notes" feature):

Up: Full Operator List
Previous: exportedString("item",template)  Next: first(item[,N]) 

A Tinderbox Reference File : Actions & Rules : Operators : Full Operator List : find(query)

Quicklinks: Attributes | Action Codes | Export Codes | Designators | Date Formats | aTbRef Site Map

[Last updated: 16 May 2012, using v5.11.1]


Search:

Google search aTbRef for:  


Creative Commons Licence

aTbRef by Mark Anderson is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 3.0 Unported License.

[See aTbRef CC licence Attribution & Waiver info]

Made with Tinderbox