Timothy Appnel > XML-Elemental-2.11 > XML::Elemental

Download:
XML-Elemental-2.11.tar.gz

Dependencies

Annotate this POD

CPAN RT

New  1
Open  2
View/Report Bugs
Module Version: 2.11   Source  

NAME ^

XML::Elemental - simplistic and perlish handling of XML data.

SYNOPSIS ^

 use XML::Elemental; 
 my $p = XML::Elemental->parser; 
 my $xml = '<foo>There is a <helloworld/> in my soup.</foo>';
 my $tree = $p->parse_string($xml);

DESCRIPTION ^

XML::Elemental is a SAX-based package for easily parsing XML documents into a more native and mostly object-oriented perl form.

The development of this package grew out of the desire for something more object-oriented then XML::Simple and was more simplistic and perlish then the various standard XML API modules such as XML::DOM. Easier installation of modules was also a contributing factor.

Original this package began as a style plugin to XML::Parser. That proved to be too limiting that it was expanded. With the release of version 2.0 the package was refactored to take advantage of any parser supporting SAX that includes the pure perl option that ships with XML::SAX.

METHODS ^

MT::Elemental->parser([\%options])

Instantiates and returns a SAX2 parser using XML::Elemental::SAXHandler as its handler and thereby inherits all the methods found in XML::SAX::Base.

The parser method can optionally take a hash reference containing SAX options. The hash reference can also include document, element and character class names to use during processing. The following keys and their defaults are used:

    KEY         DEFAULT
    Document    XML::Elemental::Document
    Element     XML::Elemental::Element
    Characters  XML::Elemental::Characters

Any class that supports the same method signatures as the XML::Elemental default classes can be used.

DEPENDENCIES ^

XML::SAX, Scalar::Util

SEE ALSO ^

XML::Simple, XML::DOM, XML::Handler::Trees

LICENSE ^

The software is released under the Artistic License. The terms of the Artistic License are described at http://www.perl.com/language/misc/Artistic.html.

AUTHOR & COPYRIGHT ^

Except where otherwise noted, XML::Elemental is Copyright 2004-2008, Timothy Appnel, tima@cpan.org. All rights reserved.

syntax highlighting: