Xport Interface: element::push_front

Inserts a markup object or PCDATA at the beginning of the called element.

virtual markup::iterator element::push_front(1st Variety
  const markup& mkup
);

virtual markup::iterator element::push_front(2nd Variety
  const std::string& pcdat
);

Parameters

mkup

A markup derived object, which can be one of the following, an element, pcdata, comment, or procinstr.

pcdat

A string argument which represents PCDATA to insert as content.

Returns

Returns a markup iterator which points to the inserted markup object.

Remarks

The first variety is equivalent to the operation element::insert(markup::begin(), markup& mkup). The second variety is equivalent to the operation element::insert(markup::begin(), std::string& pcdat). This operation provides a handy way to insert markup at the beginning of the called element, rather than at the end of the called element, which is more customary.

Complexity

logarithmic

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

  element lst(ul);
  lst.push_front(element(li) << "List item 1");
  lst.push_front(element(li) << "List item 2");
  lst.push_front(element(li) << "List item 3");
  lst.push_front(element(li) << "List item 4");
  lst.push_front(element(li) << "List item 5");

  *doc.body() << lst;

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

  return 0;
}