XML Functions (LR_XML) > Alphabetical List of Functions > lr_xml_extract

lr_xml_extract

Example: lr_xml_extract XML Functions (LR_XML)

Extracts XML fragments from an XML string.

int lr_xml_extract( <List of specifications> [, <List of optional specifications> ] [, LAST]);
List of specifications For the following list of required specifications, use the following string format:"Specification=value"
XML: the XML Input String to query
XMLFragmentParam: the name of the output parameter containing the extracted XML string fragment
Query: the XML Query or Fast Query on the input string XML.
List of optional specifications

For the following list of optional specifications, use the following string format:"Specification=value"
SelectAll: If "yes", all elements matching the query will be processed. If "no", only the first match will be processed. Default is "no". See Multiple Query Matching
ResolveNameSpaces: If "no", then XMLFragmentParam will contain the extracted string as it appears in the XML input. If "yes", then XMLFragmentParam will includefull resolution of any namespace prefixes (e.g., "a:body") in the XML input string. The Default is "no".
NotFound: See Continuing on Error

OutputFormat: One of utf-8 or locale. Default is locale.

LAST A marker which indicates the end of the List of optional specifications

The lr_xml_extract function queries the XML input string XML and extracts the fragments of the XML tree which match the Query criteria. The output parameter XMLFragmentParam contains the extracted fragments.

Return Values

See Return Values

Parameterization

See Parameterization