User Guide

172 Server-Side ActionScript Language Reference
Description
Method; appends the specified node to the XML object’s child list. This method operates
directly on the node referenced by the
childNode parameter; it does not append a copy of the
node. If the node to be appended already exists in another tree structure, appending the node
to the new location will remove it from its current location. If the
childNode parameter refers
to a node that already exists in another XML tree structure, the appended child node is placed
in the new tree structure after it is removed from its existing parent node.
Example
The following example performs the actions in this list:
1. Creates two empty XML documents, doc1 and doc2.
2. Creates a new node, using the createElement() method, and appends it, using the
appendChild() method, to the XML document named doc1.
3. Shows how to move a node using the appendChild() method, by moving the root node
from
doc1 to doc2.
4. Clones the root node from doc2 and appends it to doc1.
5. Creates a new node and appends it to the root node of the XML document doc1.
var doc1 = new XML();
var doc2 = new XML();
// Create a root node and add it to doc1.
var rootnode = doc1.createElement("root");
doc1.appendChild(rootnode);
trace ("doc1: " + doc1); // output: doc1: <root />
trace ("doc2: " + doc2); // output: doc2:
// Move the root node to doc2.
doc2.appendChild(rootnode);
trace ("doc1: " + doc1); // output: doc1:
trace ("doc2: " + doc2); // output: doc2: <root />
// Clone the root node and append it to doc1.
var clone = doc2.firstChild.cloneNode(true);
doc1.appendChild(clone);
trace ("doc1: " + doc1); // output: doc1: <root />
trace ("doc2: " + doc2); // output: doc2: <root />
// Create a new node to append to root node (named clone) of doc1.
var newNode = doc1.createElement("newbie");
clone.appendChild(newNode);
trace ("doc1: " + doc1); // output: doc1: <root><newbie /></root>
NOTE
In Flash Media Server, the output of trace() statements appears in the application log
file and Application inspector.