MACROMEDIA ColdFusion MX, Develop Manual

Page: 685 / 860

Modifying a ColdFusion XML object 685
Changing
Use the following techniques to change the contents of an element:
Adding, deleting, and modifying XML elements
The following sections describe the basic techniques for adding, deleting, and modifying XML
elements. The example code uses the XML document described in
“A simple XML document”
on page 671 .
Counting and finding the position of child elements
Often, an XML element has several children with the same name. For example, in the XML
document defined in the simple XML document, the employee root element has multiple name
elements.
To manipulate such an object, you often need to know the number of children of the same name,
and you might need to know the position in the
XmlChildren
array of a specific child name that
is used for multiple children. The following sections describe how to get this information.
Counting child elements
The following user-defined function determines the number of child elements with a specific
name in an element:
<cfscript>
function NodeCount (xmlElement, nodeName)
{
nodesFound = 0;
for ( i = 1; i LTE ArrayLen(xmlElement.XmlChildren); i = i+1)
Type Using a function Using an assignment statement
Property
StructUpdate
( xmlElemPath ,
" propertyName ", " value ")
xmlElemPath.propertyName =
" value "
xmlElemPath [" propertyName "] =
" value "
Attribute
StructUpdate( xmlElemPath .XmlAttributes,
" attributeName ", " value ")
xmlElemPath .XmlAttributes.
attributeName =" value "
xmlElemPath .XmlAttributes
[" attributeName "] = " value "
Child
element
(replace)
ArraySet
( xmlElemPath . XmlChildren ,
index ,
index , newElement )
(use the same value for both index entries to
change one element)
Replace first or only child named
elementName :
parentElemPath . elementName =
newElement
parentElemPath [" elementName "]
= newElement
Replace a specific child named
elementName :
parentElemPath . elementName
[ index ] = newElement
or
parentElemPath [" elementName "]
[ index ] = newElement