The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

Catmandu::Fix::xml_read - parse XML to MicroXML

VERSION

version 0.08

SYNOPSIS

  # parse XML string given in field 'xml' 
  xml_read(xml)
  xml_read(xml, attributes: 0)
  xml_read(xml, simple: 1)

DESCRIPTION

This Catmandu::Fix parses XML strings into MicroXML or simple XML with XML::Struct.

OPTIONS

Parsing can be configured with the following options of XML::Struct::Reader:

attributes

Include XML attributes (enabled by default).

ns

Define processing of XML namespaces (keep by default).

whitespace

Include ignorable whitespace as text elements (disabled by default).

simple

Convert to simple key-value structure as known from XML::Simple.

root

Keep (and possibly rename) root element when converting in simple form.

depth

Only transform to a given depth with option simple.

path

Parse only given elements (and all of its child elements) and return as array. For instance path => "p" in an XHTML document would return a list of parsed paragraphs (<p>...</p>).

content

not supported yet.

SEE ALSO

Catmandu::Fix::xml_write, Catmandu::Fix::xml_simple

AUTHOR

Jakob Voß

COPYRIGHT AND LICENSE

This software is copyright (c) 2014 by Jakob Voß.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.