Skip to main content

This is documentation for Caché & Ensemble.

For information on converting to InterSystems IRIS, see the InterSystems IRIS Adoption Guide and the InterSystems IRIS In-Place Conversion Guide, both available on the WRC Distributions page (login required).

Previous sectionNext section


Copies array elements from source to target.


Copy target=source


The Copy statement has the following parameters:

source The name of the variable, typically an array, which should be copied.
target The name of the variable into which the contents of source should be copied.


All nodes in the target variable are deleted prior to the copy process. The only difference between Copy and Merge is the deletion of the target nodes.


Erase source, target

target(1) = "node 1"
target(1,1) = "node 1,1"
target(2) = "node 2"
target(3,1) = "node 3,1"
source(3,2) = "node 3,2"

Copy target = source

Println Exists(target(3,1)) 'not defined anymore, returns 0
Println Exists(target(3,2)) 'does now exist, returns 1
Println Exists(target(1))   'not defined and has no subnodes, returns 0
Copy code to clipboard

See Also