MACROMEDIA COLFUSION MX 7 - INSTALLING AND USING COLDFUSION MX, Reference

Page: 910 / 1108

910 Chapter 3: ColdFusion Functions
XmlElemNew
Description
Creates an XML document object element.
Returns
An XML document object element.
Category
XML functions
Function syntax
XmlElemNew ( xmlObj [, namespace ] , childName )
See also
cfxml
,
IsXmlElem
,
XmlChildPos
,
XmlFormat
,
XmlNew
,
XmlParse
; Chapter 35, “Using XML and
WDDX” in ColdFusion MX Developer’s Guide
History
ColdFusion MX 7: Added the
namespace
parameter.
ColdFusion MX: Added this function.
Parameters
Usage
The function’s return variable specifies the location of the new element in the document object. It
must specify a valid location in the document object identified by the
xmlObj
parameter. The
following statements show this use:
MyDoc.MyRoot.XmlChildren[2] = XmlElemNew(MyDoc,"childNode");
ArrayAppend(MyDoc.MyRoot.XmlChildren, XmlElemNew(MyDoc,"childNode"));
If you do not specify a
namespace
URI and use a namespace prefix in the
childName
parameter,
ColdFusion checks to see if a namespace URI has already been specified for the prefix, and if so,
uses that namespace.
Example
The following example creates and displays a ColdFusion document object:
<cfscript>
MyDoc = XmlNew();
MyDoc.xmlRoot =
XmlElemNew(MyDoc,"MyRoot") ;
if (testVar IS TRUE)
MyDoc.MyRoot.XmlText = "The value of testVar is True.";
Parameter Description
xmlObj Name of the XML document object in which you are creating the element
namespace (Optional) URI of the namespace to which this element belongs
childName Name of the element to create