XmlSearch |
Description
Uses an XPath language expression to search an XML document that is represented as a string variable.
Returns
An array of XML object nodes that match the search criteria.
Category
Extensibility functions, XML functions
Function syntax
    XmlSearch(xmlDoc, xPathString)
See also
cfxml, IsXmlDoc, XmlChildPos, XmlChildPos, XmlFormat, XmlNew, XmlParse, XmlTransform
History
ColdFusion MX: Added this function.
Parameters
Parameter | Description
xmlDoc | XML document object
xPathString | XPath expression
Usage
XPath is specified by the World-Wide Web Consortium. For detailed information on XPath, see the W3C website at www.w3.org/TR/xpath.
Example
The following example extracts the elements named last, which contain employee last names, from the employeesimple.xml file, and displays the names.
    <cffile action="read"
       file="C:\inetpub\wwwroot\examples\employeesimple.xml"
       variable="myxml">
    <cfscript>
       myxmldoc = XmlParse(myxml);
       selectedElements = XmlSearch(myxmldoc, "/employee/name/last");
       for (i = 1; i LTE ArrayLen(selectedElements); i = i + 1)
          writeoutput(selectedElements[i].XmlText & "<br>");
    </cfscript>

xmlDoc |
XML document object

xPathString |
XPath expression