Go to main content

man pages section 3: Library Interfaces and Headers

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

XML::Parser::Style::Tree (3)

Name

XML::Parser::Style::Tree - Tree style parser

Synopsis

use XML::Parser;
my $p = XML::Parser->new(Style => 'Tree');
my $tree = $p->parsefile('foo.xml');

Description

User Contributed Perl Documentation                     Parser::Style::Tree(3)



NAME
       XML::Parser::Style::Tree - Tree style parser

SYNOPSIS
         use XML::Parser;
         my $p = XML::Parser->new(Style => 'Tree');
         my $tree = $p->parsefile('foo.xml');

DESCRIPTION
       This module implements XML::Parser's Tree style parser.

       When parsing a document, "parse()" will return a parse tree for the
       document. Each node in the tree takes the form of a tag, content pair.
       Text nodes are represented with a pseudo-tag of "0" and the string that
       is their content. For elements, the content is an array reference. The
       first item in the array is a (possibly empty) hash reference containing
       attributes. The remainder of the array is a sequence of tag-content
       pairs representing the content of the element.

       So for example the result of parsing:

         <foo><head id="a">Hello <em>there</em></head><bar>Howdy<ref/></bar>do</foo>

       would be:
                    Tag   Content
         ==================================================================
         [foo, [{}, head, [{id => "a"}, 0, "Hello ",  em, [{}, 0, "there"]],
                     bar, [         {}, 0, "Howdy",  ref, [{}]],
                       0, "do"
               ]
         ]

       The root document "foo", has 3 children: a "head" element, a "bar"
       element and the text "do". After the empty attribute hash, these are
       represented in it's contents by 3 tag-content pairs.



ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+-------------------------------+
       |ATTRIBUTE TYPE |       ATTRIBUTE VALUE         |
       +---------------+-------------------------------+
       |Availability   | library/perl-5/xml-parser-532 |
       +---------------+-------------------------------+
       |Stability      | Volatile                      |
       +---------------+-------------------------------+

NOTES
       Source code for open source software components in Oracle Solaris can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-
       code-downloads.html.

       This software was built from source available at
       https://github.com/oracle/solaris-userland.  The original community
       source was downloaded from
       http://search.cpan.org/CPAN/authors/id/T/TO/TODDR/XML-
       Parser-2.44.tar.gz.

       Further information about this software can be found on the open source
       community website at http://search.cpan.org/~toddr/.



perl v5.32.0                      2014-12-11            Parser::Style::Tree(3)