xml::sax::expat(3pm) [debian man page]

Expat(3pm)						User Contributed Perl Documentation						Expat(3pm)

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 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

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

FEATURES AND CAVEATS

       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

       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

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 AND LICENSE

       Copyright (c) 2001-2008 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.12.4							    2008-06-30								Expat(3pm)

Check Out this Related Man Page

SAX::PurePerl(3pm)					User Contributed Perl Documentation					SAX::PurePerl(3pm)

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 multiple
       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://sourceforge.net/projects/perl-xml/, in the CVS archive, under libxml-perl/docs. Hopefully
       those documents will be in a better location 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@listserv.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.14.2							    2012-06-01							SAX::PurePerl(3pm)

Linux and UNIX Man Pages

xml::sax::expat(3pm) [debian man page]

Check Out this Related Man Page