Xport Interface: descendant_iterator overview

The descendant markup iterator is a descendant iterator which traverses the descendants of the called element in a pre-order traversal. The descendant iterator has many more uses than just traversing. When used with the std algorithms, for example, the descendant iterator can be used to find a particular element in the document tree by element id, class, or other criteria. Descendant markup iterators can also be used to add content (child elements) to the element in which they point to.

Descendant markup iterator offers the common operations available to STL iterator classes, so if you're familiar with STL iterators, using markup iterators will come naturally. Examples are given for all the operations listed below.

The following list displays the operations available in descendant markup iterator.

Construction

• descendant_iterator()

Increment/Decrement

• operator ++
• operator --

Dereference

• operator *
• operator ->

Comparison

• operator ==