| ISXMLROOT | |
| Description
Determines whether the function parameter is the root element of an XML document object. |
|
| Returns
True, if the function argument is the root object of an XML document object; False, otherwise. |
|
| Category
Decision functions, XML functions |
|
Function syntaxIsXmlRoot(value) |
|
| See also
IsXML, IsXmlAttribute, IsXmlDoc, IsXmlElem, IsXmlNode, XmlGetNodeType, XmlValidate; Chapter 35, "Using XML and WDDX" in ColdFusion MX Developer's Guide |
|
| History
ColdFusion MX: Added this function. |
|
| Parameters
|
|
| Example
The following example tests whether an XML document object, its root element, and a child element are XML root elements: <!--- Create an XML document object --->
<cfxml variable="xmlobject">
<?xml version="1.0" encoding="UTF-8"?>
<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 objects to see if they are XML root elements --->
<cfoutput>
<h3>Are the following the XML Root?</h3>
xmlobject: #IsXmlRoot(xmlobject)#<br>
xmlobject.order: #IsXmlRoot(xmlobject.order)#<br>
<!--- The order element id attribute --->
xmlobject.order.XmlAttributes.id:
#IsXmlRoot(xmlobject.order.XmlAttributes.id)#<br>
</cfoutput>
|
|
| VALUE | |