xml::libxml::sax::builder(3) [osx man page]

XML::LibXML::SAX::Builder(3)				User Contributed Perl Documentation			      XML::LibXML::SAX::Builder(3)

NAME

       XML::LibXML::SAX::Builder - Building DOM trees from SAX events.

SYNOPSIS

	 use XML::LibXML::SAX::Builder;
	 my $builder = XML::LibXML::SAX::Builder->new();

	 my $gen = XML::Generator::DBI->new(Handler => $builder, dbh => $dbh);
	 $gen->execute("SELECT * FROM Users");

	 my $doc = $builder->result();

DESCRIPTION

       This is a SAX handler that generates a DOM tree from SAX events. Usage is as above. Input is accepted from any SAX1 or SAX2 event
       generator.

       Building DOM trees from SAX events is quite easy with XML::LibXML::SAX::Builder. The class is designed as a SAX2 final handler not as a
       filter!

       Since SAX is strictly stream oriented, you should not expect anything to return from a generator. Instead you have to ask the builder
       instance directly to get the document built. XML::LibXML::SAX::Builder's result() function holds the document generated from the last SAX
       stream.

AUTHORS

       Matt Sergeant, Christian Glahn, Petr Pajas

VERSION

       2.0008

COPYRIGHT

       2001-2007, AxKit.com Ltd.

       2002-2006, Christian Glahn.

       2006-2009, Petr Pajas.

perl v5.16.2							    2012-10-22					      XML::LibXML::SAX::Builder(3)

XML::LibXML::SAX(3)					User Contributed Perl Documentation				       XML::LibXML::SAX(3)

NAME

       XML::LibXML::SAX - XML::LibXML direct SAX parser

DESCRIPTION

       XML::LibXML provides an interface to libxml2 direct SAX interface. Through this interface it is possible to generate SAX events directly
       while parsing a document. While using the SAX parser XML::LibXML will not create a DOM Document tree.

       Such an interface is useful if very large XML documents have to be processed and no DOM functions are required. By using this interface it
       is possible to read data stored within an XML document directly into the application data structures without loading the document into
       memory.

       The SAX interface of XML::LibXML is based on the famous XML::SAX interface. It uses the generic interface as provided by XML::SAX::Base.

       Additionally to the generic functions, which are only able to process entire documents, XML::LibXML::SAX provides parse_chunk(). This
       method generates SAX events from well balanced data such as is often provided by databases.

FEATURES

       NOTE: This feature is experimental.

       You can enable character data joining which may yield a significant speed boost in your XML processing in lower markup ratio situations by
       enabling the http://xmlns.perl.org/sax/join-character-data feature of this parser. This is done via the set_feature method like this:

	 $p->set_feature('http://xmlns.perl.org/sax/join-character-data', 1);

       You can also specify a 0 to disable. The default is to have this feature disabled.

AUTHORS

       Matt Sergeant, Christian Glahn, Petr Pajas

VERSION

       2.0018

COPYRIGHT

       2001-2007, AxKit.com Ltd.

       2002-2006, Christian Glahn.

       2006-2009, Petr Pajas.

perl v5.16.3							    2013-05-13						       XML::LibXML::SAX(3)