XML::Parser::PerlSAX 0.08

XML::Parser::PerlSAX is a Perl SAX parser using XML::Parser.

SYNOPSIS

use XML::Parser::PerlSAX;

$parser = XML::Parser::PerlSAX->new( [OPTIONS] );
$result = $parser->parse( [OPTIONS] );

$result = $parser->parse($string);

XML::Parser::PerlSAX is a PerlSAX parser using the XML::Parser module. This man page summarizes the specific options, handlers, and properties supported by XML::Parser::PerlSAX; please refer to the PerlSAX standard in `PerlSAX.pod for general usage information.

METHODS

new

Creates a new parser object. Default options for parsing, described below, are passed as key-value pairs or as a single hash. Options may be changed directly in the parser object unless stated otherwise. Options passed to `parse() override the default options in the parser object for the duration of the parse.

parse

Parses a document. Options, described below, are passed as key-value pairs or as a single hash. Options passed to `parse() override default options in the parser object.

location

Returns the location as a hash:

ColumnNumber The column number of the parse.
LineNumber The line number of the parse.
BytePosition The current byte position of the parse.
PublicId A string containing the public identifier, or undef
if none is available.
SystemId A string containing the system identifier, or undef
if none is available.
Base The current value of the base for resolving relative
URIs.

ALPHA WARNING: The `SystemId and `PublicId properties returned are the system and public identifiers of the document passed to `parse(), not the identifiers of the currently parsing external entity. The column, line, and byte positions are of the current entity being parsed.