|Oracle Call Interface Programmer's Guide
Part Number A89857-01
OCI Datatype Mapping and Manipulation Functions, 127 of 135
Resizes the memory of a given string.
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
New memory size of the string in bytes.
new_size must include space for the
NULL character as the string terminator.
Allocated memory for the string which is freed from the OCI object cache.
This function resizes the memory of the given variable-length string in the object cache. Contents of the string are not preserved. This function may allocate the string in a new memory region, in which case the original memory occupied by the given string is freed. If
str is null, this function allocates memory for the string. If
new_size is 0, this function frees the memory occupied by
str and a null pointer value is returned.