Skip to main content

This is documentation for Caché & Ensemble. See the InterSystems IRIS version of this content.

For information on migrating to InterSystems IRIS, see Why Migrate to InterSystems IRIS?


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

See Also