Xport Interface: markup::descendant_iterator::operator ->

Pointer operator for markup::descendant_iterator and markup::const_descendant_iterator.

markup* markup::descendant_iterator::operator ->() const; descendant_iterator

const markup* markup::const_descendant_iterator::operator *() const; const_descendant_iterator

Parameters

None

Returns

Returns a pointer (or const pointer for const_descendant_iterator) to the underlying markup object.

Remarks

Returns a pointer to the underlying markup object (for descendant_iterator), and a const poiinter to the markup object (for const_descendant_iterator). This can be very handy, especially for the descendant_iterator, as it allows you to insert more content into an underlying element.

Complexity

Constant

Example

#include "xhtml_doc.h"
#include "xport_brochure.h"
#include <iostream>

int main(int argc, char* argv[])
{
  using namespace Xport;

  // create a root document
  document doc(root_doc);

  // populate the document
  xport_brochure broch;
  broch.create(doc);

  std::cout << "List all h5 elements\n\n";

  formatter fmtr(std::cout);

  markup::const_descendant_iterator it = doc.descendant_begin();
  for (; it != doc.descendant_end(); ++it) {
    if (it->tag() == h5) {
      it->write(fmtr);
      std::cout << "\n\n";
    }
  }
}