This function can extract a part from an XML file a, which is defined by the XPath expression b.

If more than one element is supplied by the XPath expression, only the first element is used.

Parameters

Parameter	Description
a	Name of the XML DOM object or XML as text. If no DOM object is found, the parameter value is interpreted as text.
b	The XPath expression.
c	(optional) If "true", errors are ignored. Default: "false".
d	(optional) If "true", the XML declaration in the result XML is omitted. Default: "false".
e	(optional) Name of the map for the namespace management . See examples for function get value from XML().

Example

Let's assume the following XML file, which you specify in parameter a either directly or via the DOM object you previously read in using function parse XML().

<?xml version="1.0"?>
<customers>
   <customer id="55000">
      <name>Charter Group</name>
      <address>
         <street>100 Main</street>
         <city>Framingham</city>
         <state>MA</state>
         <zip>01701</zip>
      </address>
      <address>
         <street>720 Prospect</street>
         <city>Framingham</city>
         <state>MA</state>
         <zip>01701</zip>
      </address>
      <address>
         <street>120 Ridge</street>
         <state>MA</state>
         <zip>01760</zip>
      </address>
   </customer>
</customers>

In parameter b we use the XPath expression "//customers/customer/address".

We leave parameters c, d and e empty.

As a result, we then get the following XML.

<?xml version="1.0" encoding="UTF-8"?>
<address>
	<street>100 Main</street>
	<city>Framingham</city>
	<state>MA</state>
	<zip>01701</zip>
</address>