Whatever message this page gives is out now! Go check it out!
Using XPath with XML documents
Last update:
May 18, 2026
XPath is a language for addressing parts of an XML document. Like XSL, XPath is a W3C specification. One of the major uses of XPath is in XSL transformations. However, XPath has more general uses. In particular, it can extract data from XML documents, such as complex data set representations. Thus, XPath is another data querying tool.
XPath uses a pattern called an XPath expression to specify the information to extract from an XML document. For example, the simple XPath expression /employee/name selects the name elements in the employee root element.
The XmlSearch function uses XPath expressions to extract data from XML document objects. The function takes an XML document object and an XPath expression in string format, and returns the results of matching the XPath expression with the XML. The returned results can be any XPath return type that ColdFusion can represent, such as an array of XML object nodes or a Boolean value. For more information, see XmlSearch in the CFML Reference.
The following example extracts all the elements named last, which contain the employee's last names, from the employeesimple.xml file, and displays the names:
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>
IMPORTANT
If you call
XmlSearch() with an XML string instead of an XML document object, ColdFusion parses the string before evaluating the XPath expression. Starting in this release, XML containing a <!DOCTYPE ...> declaration is rejected unless you pass ALLOWDOCTYPEDECLARATION=true in the params struct.<cfset params = {
ALLOWDOCTYPEDECLARATION = true,
ALLOWEXTERNALENTITIES = false,
ENTITYEXPANSIONLIMIT = 1000
}>
<cfset selectedElements = XmlSearch(myXmlString, "/employee/name/last", params)>If you already have an XML document object, this pre-parse setting is not needed at search time because the XML has already been parsed.
XPath is specified by the World Wide Web Consortium. For detailed information on XPath, see the W3C website at www.w3.org/TR/xpath. Most books that cover XSLT also discuss XPath.
We're glad. Tell us how this page helped.
We're sorry. Can you tell us what didn't work for you?
Share additional feedback to help us improve.
0/255
|
