Xport Interface: markup::rbegin

Returns a reverse child iterator pointing to the last child markup object in the element.

markup::reverse_iterator markup::rbegin();1st Variety

markup::const_reverse_iterator markup::rbegin() const;2nd Variety

Parameters

none

Returns

When called from a derived element object, returns a reverse child markup iterator (or const reverse iterator in the second variety) pointing to the last child markup object in the element. If called from any other markup derived markup object or if the element contains no children, returns markup::rend().

Remarks

This operation is revelant only if it is called on a derived element object. When called from any other object derived from markup, returns markup::rend(). When called from a derived element, this operation returns a reverse iterator to the last child markup object in the element, which is the first child object in reverse order. This reverse iterator can be used just as a regular child iterator, for traversing the element's children in reverse, retrieving information on the children, or inserting content into the children. If the called element is a const object, a const_reverse_iterator will be returned.

Complexity

Constant

Example

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

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

  // create an xhtml strict root document
  document doc(root_doc);

  // add an unordered list to the body
  markup::iterator it = doc.body()->insert(element(ul));
  *it << (element(li) << "List item 1");
  *it << (element(li) << "List item 2");
  *it << (element(li) << "List item 3");
  *it << (element(li) << "List item 4");
  *it << (element(li) << "List item 5");

  // use a reverse iterator to iterate over unordered list
  formatter fmtr(std::cout);
  markup::const_reverse_iterator rit = it->rbegin();
  for (; rit != it->rend(); ++rit) {
    fmtr << rit->front();
    std::cout << "\n";
  }

  return 0;
}