XML::SAX::Expat (3)
Leading comments
Automatically generated by Pod::Man 2.23 (Pod::Simple 3.14) Standard preamble: ========================================================================
NAME
XML::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 aSAX2
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
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
The methods defined in this class correspond to those listed in the PerlSAX2 specification, available above.FEATURES AND CAVEATS
- supported_features
-
Returns:
* xml.org/sax/features/external-general-entities * 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
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
- reuse Ken's tests and add more