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.