XML::SAX::DocumentLocator - Helper class for document locators
my $locator = XML::SAX::DocumentLocator->new( sub { $object->get_public_id }, sub { $object->get_system_id }, sub { $reader->current_line }, sub { $reader->current_column }, );
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.
There is only 1 method: new. Simply pass it a list of closures that when called will return the PublicId, the SystemId, the LineNumber and the ColumnNumber, respectively.
new
The closures are passed a single parameter, the key being requested. But you're free to ignore that.
To install XML::SAX, copy and paste the appropriate command in to your terminal.
cpanm
cpanm XML::SAX
CPAN shell
perl -MCPAN -e shell install XML::SAX
For more information on module installation, please visit the detailed CPAN module installation guide.