Xport Interface: >markup::iterator::operator ->

Pointer operator for markup::iterator and markup::const_iterator.

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

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

Parameters

None

Returns

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

Remarks

Returns a pointer to the underlying markup object (for iterator), and a const poiinter to the markup object (for const_iterator). This can be very handy, especially for the non-const markup iterator, as it allows you to insert more content into an underlying element, as shown in the example below.

Complexity

Constant

Example

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

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

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

  // insert a unordered list in the body
  markup::iterator it = doc.body()->insert(element(ul));
  it->insert((element(li) << "Item 1"));
  it->insert((element(li) << "Item 2"));
  *it->insert((element(li) << "Item 3"));

  // send the doc to cout
  formatter fmtr(std::cout);
  fmtr << doc;
  std::cout << "\n\n";

  // iterate over the unordered list and output li elements
  markup::const_iterator cit = it->begin();
  for (; cit != it->end(); ++cit) {
    cit->write(fmtr);
  }
}