XmlAddNode Function

Adds a node created with XmlNewNode to a node tree.

Usage

node_id = XmlAddNode(parent_node, new_node)

Input Parameters

parent_node—The parent node ID to attach the new node to.

new_node—The node ID of the new node to attach (returned by XmlNewNode).

Returned Value

node_id—A new XML node handle.

Keywords

Doc_id—If present, the first argument is a document ID (called the root element) as is returned by XmlNewDoc. You can only attach a single node to this top level document ID.

Discussion

This routine is used in conjunction with XmlNewNode to create and add nodes either to an existing XML document (parsed with XmlParse) or a new XML document (created with XmlNewDoc).

Example 1

This example creates two separate nodes and adds one to the other.

; Create a new node.
parent_node = XmlNewNode('ChartTitle')
; Create a second node.
child_node = XmlNewNode('Attribute', Content='Line Chart')
; Add two nodes.
new_node = XmlAddNode(parent_node, child_node)

Example 2

This example creates the same node in Example 1 but adds the newly created node to a new XML document.

; Create a new document
new_doc = XmlNewDoc('Chart')
; Create a new node.
parent_node = XmlNewNode('ChartTitle')
; Create a second node.
child_node = XmlNewNode('Attribute', Content='Line Chart')
; Add the two nodes to form a sub tree.
sub_node = XmlAddNode(parent_node, child_node)
; When adding a node to document, the doc_id keyword is required.
new_node = XmlAddNode(new_doc, sub_node, /Doc_id)