Expat(3) User Contributed Perl Documentation Expat(3)NAMEXML::SAX::Expat - SAX2 Driver for Expat (XML::Parser)
SYNOPSIS
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
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.source-
forge.net/cgi-bin/viewcvs.cgi/~check-
out~/perl-xml/libxml-perl/doc/sax-2.0.html?rev=HEAD&con-
tent-type=text/html
A more friendly URL as well as a PODification of the spec are in the
works.
METHODS
The methods defined in this class correspond to those listed in the
PerlSAX2 specification, available above.
MISSING PARTS
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_docu-
ment_locator is not yet called.
CAVEATS
- this module supports the features http://xml.org/sax/features/external-general-entities
and http://xml.org/sax/features/external-parameter-entities but turning one 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.
TODO
- reuse Ken's tests and add more
AUTHOR
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
Copyright (c) 2001-2007 Robin Berjon. All rights reserved. This program
is free software; you can redistribute it and/or modify it under the
same terms as Perl itself.
SEE ALSO
XML::Parser::PerlSAX
perl v5.8.8 2007-06-10 Expat(3)