Tinderbox 7 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]

 Baseline

 


first("item"[,N])

Returns Boolean 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().