13.4. XML::Parser Styles

Debug

Prints out the document in outline form.

Subs

Allows you to define a subroutine so that when an element is encountered, the subroutine by that name is called, using the same parameters that the Start handler is called with. When an element ends, a subroutine with that name appended with an underscore ("_") is called with the same parameters that the End handler is called with.

Tree

Returns a parse tree for the document. Each node in the tree takes the form of a tag/content pair. Text nodes use a pseudo-tag of ``0'' and the string that is their content. Elements represent their content in an array reference, in which the first item in the array is a hash reference containing attributes (if any). The remainder of the array is a sequence of tag/content pairs representing the content of the element.

Objects

Similar to Tree, except that a hash object is created for each element.

Stream

Prints a copy of the document without comments or declarations if none of the following routines are found:

StartDocument

Called at the start of the parse.

StartTag

Called for every start tag with a second parameter of the element type. The $_ variable contains a copy of the tag, and the %_ variable contains attribute values supplied for that element.

EndTag

Called for every end tag with a second parameter of the element type. The $_ variable will contain a copy of the end tag.

Text

Called just before start or end tags with accumulated non-markup text in the $_ variable.

PI

Called for processing instructions. The $_ variable will contain a copy of the PI, and the target and data are sent as second and third parameters, respectively.

EndDocument

Called at conclusion of the parse.

---

13.3. Expat Handlers		13.5. Expat Encodings

---

Copyright © 2002 O'Reilly & Associates. All rights reserved.