NAME

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

SYNOPSIS

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

DESCRIPTION

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

CONFIGURATION

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 to "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>"). This option overrides option "root".

content

Name of text content when converting to "simple" form

SEE ALSO

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