# phpman > man > XML::Handler::BuildDOM(3pm)

## NAME
    [XML::Handler::BuildDOM](https://www.chedong.com/phpMan.php/perldoc/XML%3A%3AHandler%3A%3ABuildDOM/markdown) - PerlSAX handler that creates [XML::DOM](https://www.chedong.com/phpMan.php/perldoc/XML%3A%3ADOM/markdown) document structures

## SYNOPSIS
     use [XML::Handler::BuildDOM](https://www.chedong.com/phpMan.php/perldoc/XML%3A%3AHandler%3A%3ABuildDOM/markdown);
     use [XML::Parser::PerlSAX](https://www.chedong.com/phpMan.php/perldoc/XML%3A%3AParser%3A%3APerlSAX/markdown);

     my $handler = new [XML::Handler::BuildDOM](https://www.chedong.com/phpMan.php/perldoc/XML%3A%3AHandler%3A%3ABuildDOM/markdown) (KeepCDATA => 1);
     my $parser = new [XML::Parser::PerlSAX](https://www.chedong.com/phpMan.php/perldoc/XML%3A%3AParser%3A%3APerlSAX/markdown) (Handler => $handler);

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

## DESCRIPTION
    [XML::Handler::BuildDOM](https://www.chedong.com/phpMan.php/perldoc/XML%3A%3AHandler%3A%3ABuildDOM/markdown) creates [XML::DOM](https://www.chedong.com/phpMan.php/perldoc/XML%3A%3ADOM/markdown) document structures (i.e. [XML::DOM::Document](https://www.chedong.com/phpMan.php/perldoc/XML%3A%3ADOM%3A%3ADocument/markdown)) from
    PerlSAX events.

    This class used to be called [XML::PerlSAX::DOM](https://www.chedong.com/phpMan.php/perldoc/XML%3A%3APerlSAX%3A%3ADOM/markdown) prior to libxml-enno 1.0.1.

  CONSTRUCTOR OPTIONS
    The [XML::Handler::BuildDOM](https://www.chedong.com/phpMan.php/perldoc/XML%3A%3AHandler%3A%3ABuildDOM/markdown) 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 DocType (if set), otherwise it
        will create a new [XML::DOM::Document](https://www.chedong.com/phpMan.php/perldoc/XML%3A%3ADOM%3A%3ADocument/markdown).

    *   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 possible). Otherwise it adds
        a new [XML::DOM::DocumentType](https://www.chedong.com/phpMan.php/perldoc/XML%3A%3ADOM%3A%3ADocumentType/markdown) to the Document.