Xport Interface: element::operator <<

Inserts a markup object or PCDATA into the called element.

virtual markup& element::operator <<(
1st Variety
  const markup& mkup
);

virtual markup& element::operator<<(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 reference to the element's base class, markup. This allows the chaining of the operation, which is most useful when inserting multiple markup objects.

Remarks

The first variety above inserts a markup object into the element object. The markup object is inserted at the end of the called element. If you wish to insert markup objects anywhere before the end of the current markup children, use the markup::insert() operation. This operation is equivalent to the push_back() operation.

The second variety inserts PCDATA into the called element. The passed PCDATA is enclosed within a pcdata object before being inserted into the called element, and is inserted at the end of any other markup objects which may be present in the 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  << (element(li) << "Item 1");
  lst << (element(li) << "item 2");
  lst << (element(li) << "Item 3");

  *doc.body() << lst;

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

  return 0;
}
  

#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  << (element(li) << "Item 1");
  lst << (element(li) << "item 2");
  lst << (element(li) << "Item 3");

  *doc.body() << lst;

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

  return 0;
}