collect()

Tinderbox Icon

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: Full Operator List
Previous: brightness(color,value)  Next: collect_if() 

[Last updated: 1 Dec 2008]

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