DEPRECATED - use first().
#first( note[, N] )
Gathers the first child of a specified note. Alternatively, a path my be supplied instead of a note name. The optional second argument gathers the first N children of a specified note; if N is omitted, a default value of 1 is assumed.
In agent create/rename dialogs this is listed as 'first inside'.
N may be:
- a number, e.g. 6
- an export template expression, e.g. ^value($MyCount)^ (NOTE: deprecated usage)
- an attribute expression, e.g. $MyCount+3
Prior to this N could only be a literal number character.
Deprecated in favour of action operator first().