OCINumberFromInt()

Purpose

Converts an integer to an Oracle number.

Syntax

sword OCINumberFromInt ( OCIError            *err,
                         CONST dvoid         *inum, 
                         uword               inum_length,
                         uword               inum_s_flag,
                         OCINumber           *number );

Parameters

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

inum (IN)

Pointer to the integer to convert.

inum_length (IN)

Size of the integer.

inum_s_flag (IN)

Flag that designates the sign of the integer, as follows:

• OCI_NUMBER_UNSIGNED - Unsigned values
• OCI_NUMBER_SIGNED - Signed values

number (OUT)

Given integer converted to Oracle number.

Comments

This is a native type conversion function. It converts any Oracle standard machine-native integer type, such as ub4 or sb2, to an Oracle number.

This function returns an error if the number is too big to fit into an Oracle number, if number or inum is null, or if an invalid sign flag value is passed in inum_s_flag.

Related Functions

OCIErrorGet(), OCINumberToInt()