OCINumberToReal()

Purpose

Converts an Oracle number type to Real.

Syntax

sword OCINumberToReal ( OCIError            *err,
                        CONST OCINumber     *number,
                        uword               rsl_length,
                        dvoid               *rsl );

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

number (IN)

Number to convert.

rsl_length (IN)

The size of the desired result, which equals sizeof({ float | double | long double}).

rsl (OUT)

Pointer to space for storing the result.

Comments

This is a native type conversion function. It converts an Oracle number into a machine-native real type. This function only converts numbers up to LDBL_DIG, DBL_DIG, or FLT_DIG digits of precision and removes trailing zeroes. The above constants are defined in float.h.

This function returns an error if number or rsl is null, or if rsl_length = 0.

Related Functions

OCIErrorGet(), OCINumberFromReal()