| XMLELEMNEW | |
| Description
Creates an XML document object element. |
|
| Returns
An XML document object element. |
|
| Category
XML functions |
|
Function syntaxXmlElemNew(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.";
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#>
|
|
| XMLOBJ | |
| NAMESPACE | |
| CHILDNAME | |