This version is out of date, covering development from v8.0.0 to v8.x.x. It is maintained here only for inbound reference links from elsewhere. It is no longer actively updated.

Jump to the current version of aTbRef

Tinderbox v8 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().