XML::SAX::PurePerl
SAX::PurePerl(3) User Contributed Perl Documentation SAX::PurePerl(3)
NAME
XML::SAX::PurePerl - Pure Perl XML Parser with SAX2 interface
SYNOPSIS
use XML::Handler::Foo;
use XML::SAX::PurePerl;
my $handler = XML::Handler::Foo->new();
my $parser = XML::SAX::PurePerl->new(Handler => $handler);
$parser->parse_uri("myfile.xml");
DESCRIPTION
This module implements an XML parser in pure perl. It is written
around the upcoming perl 5.8’s unicode support and support for multi-
ple document encodings (using the PerlIO layer), however it has been
ported to work with ASCII/UTF8 documents under lower perl versions.
The SAX2 API is described in detail at http://source-
forge.net/projects/perl-xml/, in the CVS archive, under
libxml-perl/docs. Hopefully those documents will be in a better loca-
tion soon.
Please refer to the SAX2 documentation for how to use this module - it
is merely a front end to SAX2, and implements nothing that is not in
that spec (or at least tries not to - please email me if you find
errors in this implementation).
BUGS
XML::SAX::PurePerl is slow. Very slow. I suggest you use something
else in fact. However it is great as a fallback parser for XML::SAX,
where the user might not be able to install an XS based parser or C
library.
Currently lots, probably. At the moment the weakest area is parsing
DOCTYPE declarations, though the code is in place to start doing this.
Also parsing parameter entity references is causing me much confusion,
since it’s not exactly what I would call trivial, or well documented
in the XML grammar. XML documents with internal subsets are likely to
fail.
I am however trying to work towards full conformance using the Oasis
test suite.
AUTHOR
Matt Sergeant, matt@sergeant.org. Copyright 2001.
Please report all bugs to the Perl-XML mailing list at perl-xml@list-
serv.activestate.com.
LICENSE
This is free software. You may use it or redistribute it under the
same terms as Perl 5.7.2 itself.
perl v5.8.8 2008-08-05 SAX::PurePerl(3)