copy

copy(toColl: Collection input);

The copy method of the Collection class copies entries from the receiver collection to a compatible collection passed as the toColl parameter. In this case, compatible means that the memberships of the receiver and destination collections are type-compatible. For example, the copy method can be used to copy entries from a dictionary of employees to an array of objects, as shown in the following examples.

create personArray transient;
dept.allEmployees.copy(personArray);

dept1.employees.copy(dept2.employees);

By default, entries copied from the receiver collection are added to entries that already exist in the collection to which you copy them.