Xport Interface: procinstr::write

Writes the procinstr object to a file or stream.

virtual void procinstr::write(
  const formatter& fmtr
);

Parameters

fmtr

A formatter object, which determines the output file or stream, and how the xhtml output will be formatted.

Returns

Nothing.

Remarks

This operation is used to write the procinstr object to a file or stream.

This operation is used internally when calling document::write() for all procinstr objects in the document. To use this operation, you must first create a formatter object. When creating a formatter object, you specify the output file or stream, and any format options for the output.

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;
  markup::iterator pit = doc.insert(it, procinstr("php include 'somefile.htm';"));

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

  // write the pcocessing instruction
  pit->write(fmtr);

  return 0;
}