Go to main content

man pages section 3: Library Interfaces and Headers

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

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

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



ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+----------------------------+
       |ATTRIBUTE TYPE |      ATTRIBUTE VALUE       |
       +---------------+----------------------------+
       |Availability   | library/perl-5/xml-sax-532 |
       +---------------+----------------------------+
       |Stability      | Volatile                   |
       +---------------+----------------------------+

NOTES
       Source code for open source software components in Oracle Solaris can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-
       code-downloads.html.

       This software was built from source available at
       https://github.com/oracle/solaris-userland.  The original community
       source was downloaded from
       http://search.cpan.org/CPAN/authors/id/G/GR/GRANTM/XML-SAX-0.99.tar.gz.

       Further information about this software can be found on the open source
       community website at http://search.cpan.org/~grantm/XML-
       SAX-0.99/SAX.pm.



perl v5.32.0                      2011-09-04                  SAX::PurePerl(3)