|Oracle Call Interface Programmer's Guide
Release 2 (9.2)
Part Number A96584-01
OCI Datatype Mapping and Manipulation Functions, 3 of 134
Assigns (deep-copies) one collection to another.
The OCI environment handle initialized in object mode.
The OCI error handle. If there is an error, it is recorded in
err and this function returns OCI_ERROR. Obtain diagnostic information by calling
Right-hand side (source) collection to be assigned from.
Left-hand side (target) collection to be assigned to.
rhs (source) to
lhs (target). The
lhs collection may be decreased or increased depending upon the size of
rhs. If the
lhs contains any elements then the elements will be deleted prior to the assignment. This function performs a deep copy. The memory for the elements comes from the object cache.
An error is returned if the element types of the
rhs collections do not match. Also, an error is returned if the upper-bound of the
lhs collection is less than the current number of elements in the
rhs collection. An error is also returned if:
lhscollection is less than the current number of elements in the