1 of 1

EXTRACTVALUE

Extract a value from XML. This function returns the text content of an XML fragment matching a given XPath expression.

Syntax

Description

The EXTRACTVALUE() function takes two string arguments: a fragment of XML markup and an XPath expression, (also known as a locator). It returns the text (That is, CDDATA), of the first text node which is a child of the element or elements matching the XPath expression.

In cases where a valid XPath expression does not match any text nodes in a valid XML fragment, (including the implicit /text() expression), the EXTRACTVALUE() function returns an empty string.

Invalid Arguments

When either the XML fragment or the XPath expression is NULL, the EXTRACTVALUE() function returns NULL. When the XML fragment is invalid, it raises a warning Code 1525:

When the XPath value is invalid, it generates an Error 1105:

Explicit text() Expressions

This function is the equivalent of performing a match using the XPath expression after appending /text(). In other words:

Count Matches

When EXTRACTVALUE() returns multiple matches, it returns the content of the first child text node of each matching element, in the matched order, as a single, space-delimited string.

By design, the EXTRACTVALUE() function makes no distinction between a match on an empty element and no match at all. If you need to determine whether no matching element was found in the XML fragment or if an element was found that contained no child text nodes, use the XPath count() function.

For instance, when looking for a value that exists, but contains no child text nodes, you would get a count of the number of matching instances:

Alternatively, when looking for a value that doesn't exist, count() returns 0.

Matches

Important: The EXTRACTVALUE() function only returns CDDATA. It does not return tags that the element might contain or the text that these child elements contain.

Note, in the above example, while the XPath expression matches to the parent <case> instance, it does not return the contained <email> tag or its content.

Examples

_{This page is licensed: GPLv2, originally from}

EXTRACTVALUE

Extract a value from XML. This function returns the text content of an XML fragment matching a given XPath expression.

Syntax

EXTRACTVALUE(xml_frag, xpath_expr)

Description

In cases where a valid XPath expression does not match any text nodes in a valid XML fragment, (including the implicit /text() expression), the EXTRACTVALUE() function returns an empty string.

Invalid Arguments

When either the XML fragment or the XPath expression is NULL, the EXTRACTVALUE() function returns NULL. When the XML fragment is invalid, it raises a warning Code 1525:

When the XPath value is invalid, it generates an Error 1105:

Explicit text() Expressions

This function is the equivalent of performing a match using the XPath expression after appending /text(). In other words:

Count Matches

When EXTRACTVALUE() returns multiple matches, it returns the content of the first child text node of each matching element, in the matched order, as a single, space-delimited string.

For instance, when looking for a value that exists, but contains no child text nodes, you would get a count of the number of matching instances:

Alternatively, when looking for a value that doesn't exist, count() returns 0.

Matches

Important: The EXTRACTVALUE() function only returns CDDATA. It does not return tags that the element might contain or the text that these child elements contain.

Note, in the above example, while the XPath expression matches to the parent <case> instance, it does not return the contained <email> tag or its content.

Examples

_{This page is licensed: GPLv2, originally from}