unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (Debian-5.0)
Page:
Section:
Apropos / Subsearch:
optional field

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, kenATbitsko.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.10.0                      2008-06-30                        Expat(3pm)