OCI Datatype Mapping and Manipulation Functions, 123 of 134

OCIStringAssign()

Purpose

Assigns one string to another string.

Syntax

sword OCIStringAssign ( OCIEnv               *env, 
                        OCIError             *err, 
                        CONST OCIString      *rhs, 
                        OCIString            **lhs );

Parameters

env (IN/OUT)

The OCI environment handle initialized in object mode.

See Also:

OCIEnvCreate() and OCIInitialize()

err (IN/OUT)

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 OCIErrorGet().

rhs (IN)

Right-hand side (source) of the assignment. Can be in UTF-16.

lhs (IN/OUT)

Left-hand side (target) of the assignment. Its buffer is UTF-16 if rhs is UTF-16.

Comments

Assigns rhs string to lhs string. The lhs string may be resized depending upon the size of the rhs. The assigned string is null-terminated. The length field will not include the extra codepoint or byte needed for null-termination.

This function returns an error if the assignment operation runs out of space.

Related Functions

OCIErrorGet(), OCIStringAssignText()