XmlSearch

Uses an XPath language expression to search an XML document that is represented as a string variable.

An array of XML object nodes that match the search criteria.

Extensibility functions, XML functions

XmlSearch(xmlDoc, xPathString)

cfxml, IsXmlDoc, XmlChildPos, XmlChildPos, XmlFormat, XmlNew, XmlParse, XmlTransform

ColdFusion MX: Added this function.

Parameter Description

xmlDoc

XML document object

xPathString

XPath expression

XPath is specified by the World-Wide Web Consortium. For detailed information on XPath, see the W3C website at www.w3.org/TR/xpath.

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>

View comments on LiveDocs