InsertChildNode method: Node class

Syntax

InsertChildNode(NodeName)

Description

The InsertChildNode method inserts a new node (as specified by NodeName) as a child node under the node object executing the method. The node specified by NodeName must be a new node. You receive an error if the node already exists.

A node object associated with the new node is returned. If the new node isn’t inserted successfully, the method returns False or Null.

Parameters

Parameter	Description
NodeName	Specify a name for the new node. This parameter takes a string value. NodeName must not already exist.

Returns

A reference to the new node. If this method fails, it returns either False or a Null object reference, depending upon the type of error encountered. The best way to test whether the object was inserted is to test the result using either the All or None functions.

Example

&NEWNODE = &MYNODE.InsertChildNode("100500");

If None(&NEWNODE) Then 
   /* Do error processing */ 
End-If;