Operator Scope of Action:
Operator First Added:
Returns Boolean true if the current note is among the last 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 7, then if first() is run on its parent container with 10 children:
first("Note A", 5) returns true
but if it has a $SiblingOrder value of 2:
first("Note A", 5) returns false
This replaces the legacy #last query operator. last() also has a logical opposite in first().