Xport Interface: element::push_back

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

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

virtual markup::iterator element::push_back(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 an iterator which points to the inserted markup object.

Remarks

The first variety is equivalent to the operation element::insert(markup& mkup). The second variety is equivalent to the operation element::insert(std::string& pcdat). The insert() operations, however, have overloads which allow markup objects to be inserted anywhere amongst possible other children within the element, while push_back() always inserts a markup object at the end of the called element.

Complexity

logarithmic

Example

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

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

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

  element lst(ul);
  lst.push_back(element(li) << "Item 1");
  lst.push_back(element(li) << "item 2");
  lst.push_back(element(li) << "Item 3");
  
  *doc.body()->push_back(lst);

  formatter fmtr(std::cout);
  fmtr.option(max_line_length, 60);
  fmtr << doc;

  return 0;
}