XML::Handler::CanonXMLWriter (3pm)

 use XML::Handler::CanonXMLWriter;

 $writer = XML::Handler::CanonXMLWriter OPTIONS;
 $parser->parse(Handler => $writer);

\*(C`XML::Handler::CanonXMLWriter\*(C' is a PerlSAX handler that will return a string or write a stream of canonical \s-1XML\s0 for an \s-1XML\s0 instance and it's content.

\*(C`XML::Handler::CanonXMLWriter\*(C' objects hold the options used for writing the \s-1XML\s0 objects. Options can be supplied when the the object is created,

$writer = new XML::Handler::CanonXMLWriter PrintComments => 1;

or modified at any time before calling the parser's `\*(C`parse()\*(C'' method:

$writer->{PrintComments} = 0;

IOHandle

IOHandle contains a handle for writing the canonical \s-1XML\s0 to. If an IOHandle is not provided, the canonical \s-1XML\s0 string will be returned from `\*(C`parse()\*(C''.

PrintComments

By default comments are not written to the output. Setting comment to a true value will include comments in the output.

Ken MacLeod, [email protected]

perl\|(1), PerlSAX

James Clark's Canonical \s-1XML\s0 definition <http://www.jclark.com/xml/canonxml.html>