REMOVE-CHILD( ) method

Unlinks the node and its sub-tree from the XML document. The XML object is not deleted, only disconnected from the structure.

Return type: LOGICAL

Applies to: X-document object handle, X-noderef object handle

Syntax

REMOVE-CHILD ( x-node-handle )

x-node-handle

The handle that represents the node to remove from the tree.

The following code fragment gets a reference to the fourth node on the document root, and removes it. hNoderef is still available for use after the remove, but is unlinked from hRoot:

CREATE X-NODEREF hNoderef.
. . .
hRoot:GET-CHILD(hNoderef,4).
hRoot:REMOVE-CHILD(hNodeRef).
. . .