Tinderbox v9 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.

If the current note has a $SiblingOrder value of 2, then if first() is run on its parent container:

first("Note A", 5) returns true

but if 'it has a $SiblingOrder value of 7:

first("Note A", 5) returns false

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