CFML Reference

XmlElemNew

Description

Creates an XML document object element.

Return value

An XML document object element.

Category

Extensibility functions, XML functions

Syntax

XmlElemNew(xmlObj, childName) 

See also

cfxml, IsXmlDoc, XmlChildPos, XmlFormat, XmlNew, XmlParse, XmlSearch, XmlTransform

History

New in ColdFusion MX: this function is new.

Parameters

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.

Example

The following example creates and displays a ColdFusion document object. For more information on this example, see Developing ColdFusion MX Applications with CFML.

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 &".";
    }
</cfscript>
<cfdump var=#MyDoc#>

Copyright © 2002, Macromedia Inc. All rights reserved.

Comments