View comments | RSS feed

IsXmlElem

Description

Determines whether the function parameter is an XML document object element.

Returns

True, if the function argument is an XML document object element; False, otherwise.

Category

Decision functions, XML functions

Function syntax

IsXmlElem(value)

See also

IsXML, IsXmlAttribute, IsXmlDoc, IsXmlNode, IsXmlRoot, XmlGetNodeType, XmlValidate; Using XML and WDDX in ColdFusion MX Developer's Guide

History

ColdFusion MX: Added this function.

Parameters

Parameter Description

value

Name of an XML document object element

Example

The following example tests whether an XML document object, the document root, and an element are elements:

<!--- Create an XML document object --->
<cfxml variable="xmlobject">
<order id="4323251">
   <customer firstname="Philip" lastname="Cramer" accountNum="21"/>
   <items>
      <item id="43">
         <quantity>1</quantity>
         <unitprice>15.95</unitprice>
      </item>
   </items>
</order>
</cfxml>

<!--- Test parts of the document object to see if they are elements --->
<cfoutput>
   <h3>Are the following XML document object elements?</h3>
   xmlobject: #IsXmlElem(xmlobject)#<br>
   xmlobject.XMLRoot: #IsXmlElem(xmlobject.XMLRoot)#<br>
   xmlobject.order.items: #IsXmlElem(xmlobject.order.items)#<br>
</cfoutput>

ColdFusion MX 7 | ColdFusion MX 6.1 | ColdFusion MX | Forums | Developer Center | KnowledgeBase | Bug Reporting

Version 7

Comments


sdwebguy99 said on Sep 13, 2005 at 4:00 PM :
Note that using this function to test the existance of a node will fail.

#IsXMLElem(xmlobject.order.items.item.title)# does not return false. It errors out.
kim il sung said on May 27, 2008 at 3:46 AM :
error at doc. this one works just fine:
<cfif IsXmlElem("OrdersDoc.orders.order[i].phone")>
phone found
<cfelse>
phone not found
</cfif>

 

RSS feed | Send me an e-mail when comments are added to this page | Comment Report

Current page: http://livedocs.adobe.com/coldfusion/7/htmldocs/00000539.htm