OCIStringAssignText()

Purpose

Assigns the source text string to the target string.

Syntax

sword OCIStringAssignText ( OCIEnv           *env,
                            OCIError         *err, 
                            CONST OraText    *rhs, 
                            ub2              rhs_len,
                            OCIString        **lhs );

Parameters

env (IN/OUT)

The OCI environment handle initialized in object mode.

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, a text or UTF-16 Unicode string.

rhs_len (IN)

Length of the rhs string in either codepoints (if Unicode) or in bytes (if non-Unicode).

lhs (IN/OUT)

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

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 byte or codepoint needed for null-termination.

Related Functions

OCIErrorGet(), OCIStringAssign()