User Guide

XML.appendChild() 1013
XML.appendChild()
Availability
Flash Player 5.
Usage
my_xml.appendChild(childNode:XMLNode) : Void
Parameters
childNode
An XMLNode that represents the node to be moved from its current location to the
child list of the
my_xml object.
Returns
Nothing.
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
This example does the following things in the order shown:
• Creates two empty XML documents, doc1 and doc2.
• Creates a new node using the createElement() method, and appends it, using the
appendChild() method, to the XML document named doc1.
• Shows how to move a node using the appendChild() method, by moving the root node from
doc1 to doc2.
• Clones the root node from doc2 and appends it to doc1.
• Creates a new node and appends it to the root node of the XML document doc1.
var doc1:XML = new XML();
var doc2:XML = new XML();
// create a root node and add it to doc1
var rootnode:XMLNode = 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