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). . . .