User Guide

742 Chapter 3: ColdFusion Functions
XmlNew
Description
Creates an XML document object.
Returns
An empty XML document object.
Category
Extensibility functions, XML functions
Function syntax
XmlNew([caseSensitive])
See also
cfxml, IsXmlDoc, XmlChildPos, XmlChildPos, XmlFormat, XmlParse, XmlSearch,
XmlTransform
History
ColdFusion MX: Added this function.
Parameters
Usage
An XML document object is represented in ColdFusion as a structure.
The
caseSensitive attribute value determines whether identifiers whose characters are of
varying case, but are otherwise the same, refer to different components. For example:
• If caseSensitive = "no", the names mydoc.employee.name[1] and
mydoc.employee.NAME[1] refer to the same element
• If caseSensitive = "yes", these names refer to two distinct elements
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.
Example
<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 &".";
Parameter Description
caseSensitive Determines how ColdFusion processes the case of XML document object
component identifiers
• yes: maintains case
• no. ColdFusion ignores case. Default.