XML::Handler::CanonXMLWriter(3)            User Contributed Perl Documentation


NAME
       XML::Handler::CanonXMLWriter - output XML in canonical XML format

SYNOPSIS
        use XML::Handler::CanonXMLWriter;

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

DESCRIPTION
       "XML::Handler::CanonXMLWriter" is a PerlSAX handler that will return a
       string or write a stream of canonical XML for an XML instance and it's
       content.

       "XML::Handler::CanonXMLWriter" objects hold the options used for
       writing the XML 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 `parse()' method:

           $writer->{PrintComments} = 0;

OPTIONS
       IOHandle
           IOHandle contains a handle for writing the canonical XML to.  If an
           IOHandle is not provided, the canonical XML string will be returned
           from `parse()'.

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

AUTHOR
       Ken MacLeod, ken@bitsko.slc.ut.us

SEE ALSO
       perl(1), PerlSAX

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

perl v5.38.2                      2024-07-12   XML::Handler::CanonXMLWriter(3)