XML::Handler::BuildDOM

XML::Handler::BuildDOMUser Contributed Perl DocumentaXML::Handler::BuildDOM(3)



NAME
       XML::Handler::BuildDOM - PerlSAX handler that creates XML::DOM document
       structures

SYNOPSIS
        use XML::Handler::BuildDOM;
        use XML::Parser::PerlSAX;

        my $handler = new XML::Handler::BuildDOM (KeepCDATA => 1);
        my $parser = new XML::Parser::PerlSAX (Handler => $handler);

        my $doc = $parser->parsefile ("file.xml");

DESCRIPTION
       XML::Handler::BuildDOM creates XML::DOM document structures (i.e.
       XML::DOM::Document) from PerlSAX events.

       This class used to be called XML::PerlSAX::DOM prior to libxml-enno
       1.0.1.

       CONSTRUCTOR OPTIONS

       The XML::Handler::BuildDOM constructor supports the following options:

       * KeepCDATA => 1
           If set to 0 (default), CDATASections will be converted to regular
           text.

       * Document => $doc
           If undefined, start_document will extract it from Element or Doc-
           Type (if set), otherwise it will create a new XML::DOM::Document.

       * Element => $elem
           If undefined, it is set to Document. This will be the insertion
           point (or parent) for the nodes defined by the following callbacks.

       * DocType => $doctype
           If undefined, start_document will extract it from Document (if pos-
           sible).  Otherwise it adds a new XML::DOM::DocumentType to the Doc-
           ument.



perl v5.8.6                       2002-02-08         XML::Handler::BuildDOM(3)