local-lib5/lib/perl5/i486-linux-gnu-thread-multi/XML/LibXML/SAX/Builder.pod

   1 =head1 NAME
   2
   3 XML::LibXML::SAX::Builder - Building DOM trees from SAX events.
   4
   5 =head1 SYNOPSIS
   6
   7
   8
   9   use XML::LibXML::SAX::Builder;
  10   my $builder = XML::LibXML::SAX::Builder->new();
  11
  12   my $gen = XML::Generator::DBI->new(Handler => $builder, dbh => $dbh);
  13   $gen->execute("SELECT * FROM Users");
  14
  15   my $doc = $builder->result();
  16
  17
  18 =head1 DESCRIPTION
  19
  20 This is a SAX handler that generates a DOM tree from SAX events. Usage is as
  21 above. Input is accepted from any SAX1 or SAX2 event generator.
  22
  23 Building DOM trees from SAX events is quite easy with
  24 XML::LibXML::SAX::Builder. The class is designed as a SAX2 final handler not as
  25 a filter!
  26
  27 Since SAX is strictly stream oriented, you should not expect anything to return
  28 from a generator. Instead you have to ask the builder instance directly to get
  29 the document built. XML::LibXML::SAX::Builder's result() function holds the
  30 document generated from the last SAX stream.
  31
  32 =head1 AUTHORS
  33
  34 Matt Sergeant,
  35 Christian Glahn,
  36 Petr Pajas
  37
  38
  39 =head1 VERSION
  40
  41 1.70
  42
  43 =head1 COPYRIGHT
  44
  45 2001-2007, AxKit.com Ltd.
  46
  47 2002-2006, Christian Glahn.
  48
  49 2006-2009, Petr Pajas.
  50
  51 =cut