debian man page for xml::sax::documentlocator

SAX::DocumentLocator(3pm)				User Contributed Perl Documentation				 SAX::DocumentLocator(3pm)

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.

perl v5.14.2							    2009-10-10						 SAX::DocumentLocator(3pm)