#17 new report function gettatgs

[elsapo]

From request & discussions on LINES-L list, Nov 2005 week 4:

http://listserv.nodak.edu/cgi-bin/wa.exe?A1=ind0511d&L=lines-l

My last proposal was here:
http://listserv.nodak.edu/cgi-bin/wa.exe?A2=ind0511d&L=lines-l&T=0&P=6185

[elsapo]

Logged In: YES
user_id=1195173
Originator: YES

EVENT gettag(RECORD, [INT depth, ] STRING tag [, STRING tag2...])
EVENT gettag(NODE base, [INT depth, ] STRING tag [, STRING tag2...])
/* find first event tag inside record or specified node */
/* default depth is 1, if not specified, and 0 for depth means any depth */

LIST gettags(RECORD, [INT depth,] STRING tag [, STRING tag2...])
LIST gettags(NODE base, [INT depth,] STRING tag [, STRING tag2...])
/* return list of nodes of given tag, under record or base node */
/* default depth is 1, if not specified, and 0 for depth means any depth */

fortags (EVENT_V, RECORD, [INT depth,] STRING tag [, STRING tag2...])
fortags (EVENT_V, NODE base, [INT depth,] STRING tag [, STRING tag2 ...])
/* loop through all nodes with any of listed tags, underneath record or base node */
/* default depth is 1, if not specified, and 0 for depth means any depth */