CFML Reference

XmlSearch

Description

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

Return value

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

Category

Extensibility functions, XML functions

Syntax

XmlSearch(xmlDoc, xPathString) 

See also

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

History

New in ColdFusion MX: this function is new.

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 http://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>

Copyright © 2002, Macromedia Inc. All rights reserved.

Comments