User Guide

740 Chapter 3: ColdFusion Functions
XmlElemNew
Description
Creates an XML document object element.
Returns
An XML document object element.
Category
Extensibility functions, XML functions
Function syntax
XmlElemNew(xmlObj, childName)
See also
cfxml, IsXmlDoc, XmlChildPos, XmlFormat, XmlNew, XmlParse, XmlSearch,
XmlTransform
History
ColdFusion MX: Added this function.
Parameters
Example
The following example creates and displays a ColdFusion document object. For more
information on this example, see Chapter 31, “Using XML and WDDX,” in Developing
ColdFusion MX Applications.
<cfset testVar = True>
<cfscript>
MyDoc = XmlNew();
MyDoc.xmlRoot = XmlElemNew(MyDoc,"MyRoot");
if (testVar IS TRUE)
MyDoc.MyRoot.XmlText = "The value of testVar is True.";
else
MyDoc.MyRoot.XmlText = "The value of testVar is False.";
for (i = 1; i LTE 4; i = i + 1)
{
MyDoc.MyRoot.XmlChildren[i] = XmlElemNew(MyDoc,"childNode");
MyDoc.MyRoot.XmlChildren[i].XmlText = "This is Child node " & i &".";
}
</cfscript>
<cfdump var=#MyDoc#>
Parameter Description
xmlObj The name of an XML object. An XML document or an element.
childName The name of the element to create. This element becomes a child element of
xmlObj in the tree.