CLONE-NODE( ) method

Clone the XML node referred to by a node reference. The first parameter must be a valid X-noderef handle and refers to the new cloned XML node if the method succeeds. The new node is associated with the same document, but needs to be inserted with INSERT-BEFORE( ) or APPEND-CHILD( ) to become part of the document structure.

Return type: LOGICAL

Applies to: X-noderef object handle

Syntax

CLONE-NODE ( x-node-handle , deep )

x-node-handle

A valid X-noderef handle to use for the new XML node.

deep

A logical that if TRUE specifies that the whole sub-tree is to be cloned. The default value is FALSE.

The following example demonstrates the use of the CLONE-NODE( ) method to clone an entire sub-tree:

hOldNode:CLONE-NODE(hNewNode,true).