collect(group,attribute)

Tinderbox Icon


Operator Type:   Set creation
Operator Scope of Action:   Group

A function collect() builds sets. (See collect_if() for a related new operator)

collect(where,attribute)

builds a set by visiting each note described by where and adding the value of the designated attribute to the set.

where may be any of {child,descendent,sibling,ancestor,all}. In addition, where may be argument that designates a particular (single) note other than this.

what can be any expression, but is typically an attribute.

For example,

collect(child,$Name) 

constructs a set with the name of each child of the note.

For example,

collect(child(/agents/books),$Name) 

does the same for children of the note 'books' inside 'agents'.


Up: Set creation operators
  Next: collect_if(group,condition,attribute) 

[Last updated: 14 Dec 2009, using v5.0]

Google search aTbRef for:  

Licensed under Creative Commons Attribution-Noncommercial-Share Alike 3.0 License
[See aTbRef CC licence Attribution/Waiver info info]

Creative Commons License

Made with Tinderbox