Whatever message this page gives is out now! Go check it out!

XmlGetNodeType

Last update:
May 18, 2026

Description

Determines the type of an XML document object node.

Returns

A string identifying the XML node type. The following values are valid:
ATTRIBUTE_NODE
CDATA_SECTION_NODE
COMMENT_NODE
DOCUMENT_FRAGMENT_NODE
DOCUMENT_NODE
DOCUMENT_TYPE_NODE
ELEMENT_NODE
ENTITY_NODE
ENTITY_REFERENCE_NODE
NOTATION_NODE
PROCESSING_INSTRUCTION_NODE
TEXT_NODE
If the argument is not a document object node, the function generates an error.

Category

Function syntax

XmlGetNodeType(xmlNode)

See also

IsXmlAttributeIsXmlDocIsXmlElemIsXmlNodeIsXmlRootXmlChildPosXmlValidateUsing XML and WDDX in the Developing ColdFusion Applications

History

ColdFusion MX 7: Added this function.

Parameters

Parameter
Description
xmlNode
An XML DOM object node

Usage

The XmlGetNodeType function can determine the types of the nodes returned by the XmlSearch function, or the types of the entries in an element's XmlNodes array.

Example

The following example checks the node types of various parts of an XML document object:
<!--- 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"> 
<!-- This item is coded to show several node types --> 
<![CDATA["Our Best" hammer & chisel set!!!]]> Imported from France 
<quantity>1</quantity> 
<unitprice>15.95</unitprice> 
</item> 
</items> 
</order> 
</cfxml> 

<!--- Display the node types ---> 
<cfoutput> 
<h3>Node Types</h3> 
xmlobject: #XMLGetNodeType(xmlobject)#<br> 
xmlobject.order: #XMLGetNodeType(xmlobject.order)#<br> 
<br> 
Now check the types of all the nodes in the xmlobject.order.items.item 
element's XmlNodes array.<br> 
Note the many apparently empty Text nodes generated by whitespace characters in the XML text source.<br><br> 
<cfset descnodes=xmlobject.order.items.item.XmlNodes> 
<cfloop from="1" to="#ArrayLen(descnodes)#" index="i"> 
#i# Node type is: #XMLGetNodeType(descnodes[i])#<br> 
#i# Node name is: #descnodes[i].XmlName#<br> 
<cfif (descnodes[#i#].XmlValue NEQ "")> 
#i# Node value is: #descnodes[i].XmlValue#<br> 
</cfif> 
<br> 
</cfloop> 
</cfoutput>

Share this page

Was this page helpful?
We're glad. Tell us how this page helped.
We're sorry. Can you tell us what didn't work for you?
Thank you for your feedback. Your response will help improve this page.

On this page