Xport Interface: procinstr::operator <<

Inserts text in the called procinstr object.

virtual markup& procinstr::operator<<(
  const std::string&  text
);

Parameters

pcdat

A string argument which represents text to insert as part of the processing instruction.

Returns

Returns a reference to the procinstr's base class, markup. This allows the chaining of the operation, which is most useful when inserting text multiple times.

Remarks

This operation inserts text into the called procinstr object. The passed text is inserted at the end of any text which may be present in the procinstr object.

Complexity

Constant

Example

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

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

  document doc(root_doc);

  // create a php processing instruction which includes another file
  markup::iterator it = doc.begin();
  ++it;

  procinstr pi("php include 'somefile.htm';");

  // add to the procinstr
  pi << "\ninclude 'someotherfile.htm';";

  // insert the processing instruction into the document
  doc.insert(it, pi);

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

  return 0;
}