XML::SAX::Expat - SAX2 Driver for Expat (XML::Parser)


XML-SAX-Expat documentation  | view source Contained in the XML-SAX-Expat distribution.

Index


NAME

Top

XML::SAX::Expat - SAX2 Driver for Expat (XML::Parser)

SYNOPSIS

Top

  use XML::SAX::Expat;
  use XML::SAX::MyFooHandler;
  my $h = XML::SAX::MyFooHandler->new;
  my $p = XML::SAX::Expat->new(Handler => $h);
  $p->parse_file('/path/to/foo.xml');

DESCRIPTION

Top

This is an implementation of a SAX2 driver sitting on top of Expat (XML::Parser) which Ken MacLeod posted to perl-xml and which I have updated.

It is still incomplete, though most of the basic SAX2 events should be available. The SAX2 spec is currently available from http://cvs.sourceforge.net/cgi-bin/viewcvs.cgi/~checkout~/perl-xml/libxml-perl/doc/sax-2.0.html?rev=HEAD&content-type=text/html

A more friendly URL as well as a PODification of the spec are in the works.

METHODS

Top

The methods defined in this class correspond to those listed in the PerlSAX2 specification, available above.

FEATURES AND CAVEATS

Top

supported_features

Returns:

  * http://xml.org/sax/features/external-general-entities
  * http://xml.org/sax/features/external-parameter-entities
  * [ Features supported by ancestors ]

Turning one of the first two on also turns the other on (this maps to the XML::Parser ParseParamEnts option). This may be fixed in the future, so don't rely on this behaviour.

MISSING PARTS

Top

XML::Parser has no listed callbacks for the following events, which are therefore not presently generated (ways may be found in the future):

  * ignorable_whitespace
  * skipped_entity
  * start_entity / end_entity
  * resolve_entity

Ways of signalling them are welcome. In addition to those, set_document_locator is not yet called.

TODO

Top

  - reuse Ken's tests and add more

AUTHOR

Top

Robin Berjon; stolen from Ken Macleod, ken@bitsko.slc.ut.us, and with suggestions and feedback from perl-xml. Currently maintained by Bjoern Hoehrmann http://bjoern.hoehrmann.de/.

COPYRIGHT AND LICENSE

Top

SEE ALSO

Top

XML::Parser::PerlSAX


XML-SAX-Expat documentation  | view source Contained in the XML-SAX-Expat distribution.