unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (Debian-5.0)
Page:
Section:
Apropos / Subsearch:
optional field

SAX::DocumentLocator(3User Contributed Perl DocumentaSAX::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 ColumnNum-
       ber.

       It is useful for writing SAX Parsers so that you don't have to con-
       stantly 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.8.8                       2005-10-14         SAX::DocumentLocator(3pm)