User Guide

XmlSearch 745

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.

See also

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

XmlTransform

History

ColdFusion MX: Added this function.

Parameters

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">

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>

Parameter Description

xmlDoc XML document object

xPathString XPath expression