Effect and Restrictions

Effect:

Copy the values of the elements in the source array to the corresponding elements in the destination.

Type restrictions:

The elements of the source and destination arrays must have the same type if primitive. If the element types are Object, subtypes of all objects referenced by elements of the source array must be assignable to elements of the destination array.

Shape restrictions:

The source and destination arrays must have the same shape.

Containment restrictions:

The source and destination arrays must be fully contained in the active process group.

Overlap restrictions:

In-place updates are not allowed. The source and destination arrays must not overlap--no element of source array must be an alias for an element of the destination array. This is only an issue if both arguments are sections of the same array.

Replicated data:

If the source array has replicated mapping, the value for a particular element is taken from one of its copies. If the destination array has replicated mapping, identical values are broadcast to every copy of the elements.