XML::Parser Methods (Perl in a Nutshell, 2nd Edition)

new

new(%option)

Constructor. Options are passed as keyword/value pairs. Recognized options are:

Style: Sets the type of parser. The built-in styles are Debug, Subs, Tree, Objects, and Stream. Custom styles can be provided by giving a fully qualified package name containing at least one "::". This package must have subroutines defined for each parser type.
Handlers: An anonymous hash containing the handler types as the keys with their associated values, which are references to subroutines for handling that type of event.
Pkg: Some styles will refer to subroutines defined in the specified package.
ErrorContext: The number of lines to show surrounding the line in which an error occurred.
ProtocolEncoding: Sets the protocol-encoding name (default is none). The built-in encodings are UTF-8, ISO-8859-1, UTF-16, and US-ASCII. You may introduce additional encodings by adding directories to @Encoding_Path.
Namespaces: If true, then namespace processing is done during the parse.
NoExpand: Normally, the parser will try to expand references to entities defined internally. If this option is true and a default handler is also set, then the default handler will be called when an entity reference is encountered.
Stream_Delimiter: A string for XML::Parser to interpret as end-of-file if found alone on a line. Useful when working with MIME multipart documents. The string should not contain a trailing newline.
ParseParamEnt: Unless standalone is set to yes in the XML declaration, setting this to true allows the external DTD to be read, and parameter entities to be parsed and expanded.
NoLWP: If true, forces the use of a file-based external entity handler.
Non-Expat-Options: An anonymous hash whose keys are options that shouldn't be passed to Expat. This should be a concern only for those subclassing XML::Parser.

13.2. XML::Parser Methods