sax::documentlocator(3pms)
NAME
XML::SAX::DocumentLocator - Helper class for document locators
SYNOPSIS
my $locator = XML::SAX::DocumentLocator->new(
sub { $object->get_public_id },
sub { $object->get_system_id },
sub { $reader->current_line },
sub { $reader->current_column },
sub { $reader->get_encoding },
sub { $reader->get_xml_version },
);
DESCRIPTION
This module gives you a tied hash reference that calls the specified
closures when asked for PublicId, SystemId, LineNumber and
ColumnNumber.
It is useful for writing SAX Parsers so that you don't have to
constantly update the line numbers in a hash reference on the object
you pass to set_document_locator(). See the source code for
XML::SAX::PurePerl for a usage example.
API
There is only 1 method: "new". Simply pass it a list of closures that
when called will return the PublicId, the SystemId, the LineNumber, the
ColumnNumber, the Encoding and the XMLVersion respectively.
- The closures are passed a single parameter, the key being requested.
But you're free to ignore that.