Xport Interface: markup::rend

Returns a reverse child iterator pointing just in fromt of the first child markup object in the element.

markup::reverse_iterator element::rend();1st Variety

markup::const_reverse_iterator element::rend() const;2nd Variety

Parameters

none

Returns

Returns a reverse child markup iterator (or const reverse iterator in the second variety) pointing just in front of the first child markup object within the called element.

Remarks

This operation is revelant only if it is called on a derived element object, since only element's can contain other markup objects. When called from a derived element, this operation returns a reverse iterator pointing just in front of the first child markup object in the element, which is the end of the children in reverse order.

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;
}