xmlElemNew

Description

Creates an XML document object element.

History

ColdFusion MX 7: Added the namespace parameter. ColdFusion MX: Added this function.

Syntax

XmlElemNew(xmlObj[, namespace], childName)

Attributes

Attribute	Description	Required	Default
childName	Name of the element to create
namespace	(Optional) URI of the namespace to which this element belongs
xmlObj	Name of the XML document object in which you are creating the element

Returns

An XML document object element.

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."; 
    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#>

cfmldocs