This version is out of date, covering development from v5.0.0 to v5.12.2. It is maintained here only for inbound reference links from elsewhere.

Jump to the current version of aTbRef.

Tinderbox Icon

first(item[,N])


Operator Type: 

Operator Scope of Action: 

Operator Purpose: 

Operator First Added: 

Operator Altered: 

 Function   [other Function type actions]

 Item   [operators of similar scope]

 Query Boolean   [other Query Boolean operators]

 Already in v5.0.0

 


first("item"[,N])

Returns true if the current note is among the first N children of item. If N is missing, a value of 1 is assumed. The item parameter must be quoted unless an attribute reference. Ways to define item.

Both arguments are evaluated and can be a literal string/number, an attribute value or an action code expression evaluating to that same.

In the query creation pop-ups of agent and Find dialogs this function is listed as "fist inside".

This replaces the legacy #first query operator. first() also has a logical opposite in last().


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


A Tinderbox Reference File : Actions & Rules : Operators : Action Operator Functional Types : Function actions : first(item[,N])