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