Ben Nadel
On User Experience (UX) Design, JavaScript, ColdFusion, Node.js, Life, and Love.

ArrayAppend() Does Not Work With ColdFusion's XML Pseudo-Node-Sets

By Ben Nadel on
Tags: ColdFusion

I stumbled upon this the other day; at first, I was a bit confused, but the more I think about it, the more I understand that it makes perfect sense. ColdFusion's ArrayAppend() method works with XML children, but not with pseudo-XML-node-sets. Take a look at this example:

  • <!--- Define our ColdFusion XML document. --->
  • <cfxml variable="xmlData">
  • <girls>
  • <girl name="Kimmie" />
  • <girl name="Kit" />
  • <girl name="Sarah" />
  • <girl name="Jill" />
  • </girls>
  • </cfxml>
  • <!---
  • Append a duplicate girl node to the list of girl nodes.
  • By duplicating, the parent document should be handled
  • automatically.
  • --->
  • <cfset ArrayAppend(
  • xmlData.girls.girl,
  • Duplicate( xmlData.girls.girl[ 1 ] )
  • ) />
  • <!--- Dump out the new XML document. --->
  • <cfdump
  • var="#xmlData#"
  • label="xmlData After Duplicate() Append."
  • />

Here's we're just duplicating an XML node and then appending it onto the originating node list. When we run this code, we get the following ColdFusion error:

The ArrayAppend ColdFusion function is not supported on this object. The ArrayAppend ColdFusion function is not supported on an object of type coldfusion.xml.XmlNodeListWrapper. For example, XML objects can be operated on by a subset of the structure and array functions, but not all.

The problem here is that we are not using the XmlChildren collection. Rather, we are using the pseudo-node-set:


What this does is collect all of the "girl" nodes into a coldfusion.xml.XmlNodeListWrapper object to allow for easier (and perhaps more meaningful) traversal. And, in an example like the one above, it might seem silly since the girl pseudo-node-set is the same as the collection of all XmlChildren nodes. However, remember that if we have mixed nodes, the pseudo-node-set will still work.

The simple fix for this is to refer to the child nodes using the XmlChildren collection:

  • <cfset ArrayAppend(
  • xmlData.girls.XmlChildren,
  • Duplicate( xmlData.girls.girl[ 1 ] )
  • ) />

This time, the code runs as expected.

So, this is a minor note; but, if you don't realize what is going on, it could really trip you up - perhaps even make you believe that you can't append XML nodes to an existing document.

Reader Comments

Can we add a new child node that should look like the one below viz.,

<girl name="Kimmie">
<girl name="Kit" />
<girl name="Sarah" />
<girl name="Jill" />


Yeah, definitely! That's one of the beautiful things about XML - the format can be super flexible. You have have nodes that have completely different formats.

I so appreciate your blog. You're making me look good at work. I barely knew anything about XML documents before I started my current project. But now because of you and a few others, I manipulate XML documents with the best of them! :)


-- Simone