Number类型接口

OCINumberFromText

功能描述

将字符串转换为OCINumber。

功能说明

根据指定的格式将给定的字符串转换为 NUMBER。有关格式和多语言参数的说明，请参见TO_NUMBER 转换函数。

接口信息

函数/过程

OCINumberFromText的语法如下：

sword OCINumberFromText ( OCIError           *err, 
                          const OraText      *str, 
                          ub4                 str_length,
                          const OraText      *fmt,
                          ub4                 fmt_length, 
                          const OraText      *nls_params, 
                          ub4                 nls_p_length, 
                          OCINumber          *number );

参数解释如下：

err(IN/OUT)：OCI 错误句柄。如果有错误，则记录在err中，并且该函数返回OCI_ERROR。通过调用 OCIErrorGet() 获取诊断信息。
str(IN)：要转换为 OCINumber的输入字符串。例如”1234567890-“,” .10”,” -.10”,” 1”,“$123.45”,“123.456”等格式。
str_length(IN)：输入字符串的大小。
fmt(IN)：转换格式。支持”9999999999S”,“99.99”,“B9999”,“FML999.99”,“FM999.009”等转换格式。
fmt_length(IN)：转换格式长度。
nls_params(IN)：全局支持格式。如果是 NULL 字符串 (“”)，则使用会话的默认参数。
nls_p_length(IN)：nls_params的长度。
number (OUT)：输出的OCINumber类型。

其他说明

无

OCINumberToText

功能描述

根据指定格式将 OCINumber转换为字符串。

功能说明

根据格式转换为字符串，格式可以参考TO_NUMBER 函数参数。

接口信息

函数/过程

OCINumberToText的语法如下：

sword OCINumberToText ( OCIError             *err,
                        const OCINumber      *number, 
                        const OraText        *fmt, 
                        ub4                   fmt_length,
                        const OraText        *nls_params, 
                        ub4                   nls_p_length,
                        ub4                  *buf_size, 
                        OraText              *buf );;

参数解释如下：

err(IN/OUT)：OCI 错误句柄。如果有错误，则记录在err中，并且该函数返回OCI_ERROR。通过调用 OCIErrorGet() 获取诊断信息。
number (IN)：要转换的OCINumber类型。
fmt(IN)：转换格式。支持”9999999999S”,“99.99”,“B9999”,“FML999.99”,“FM999.009”等转换格式。
fmt_length(IN)：转换格式长度。
nls_params(IN)：全局支持格式。如果是 NULL 字符串 (“”)，则使用会话的默认参数。
nls_p_length(IN)：nls_params的长度。
buf_size(OUT)：转换后的字符串所在的缓冲区大小。
str(OUT)：转换后的字符串所在的缓冲区。

其他说明

无

OCINumberIsInt

功能描述

测试 OCINumber 是否为整数。

功能说明

测试 OCINumber 是否为整数，如果参数 number 或 result 为 NULL，则此函数返回错误。

接口信息

函数/过程

OCINumberIsInt 的语法如下：

sword OCINumberIsInt ( OCIError         *err, 
                       const OCINumber  *number,
                       boolean          *result );

参数解释如下：

err(IN/OUT)：OCI 错误句柄。如果有错误，则记录在err中，并且该函数返回OCI_ERROR。通过调用 OCIErrorGet() 获取诊断信息。
number (IN)：要转换的OCINumber类型。
result (OUT)：如果是整数值则设置为TRUE；否则为FALSE。

其他说明

无

OCINumberToInt

功能描述

转换OCINumber 为整数。

功能说明

这是一个原生类型转换函数。它将给定的 Oracle NUMBER 转换为 xbn 形式的整数，例如 ub2、ub4 或 sb2。

如果 number 或 rsl 为 NULL，如果 number 太大（溢出）或太小（下溢），或者在 rsl_flag 中传递了无效的符号标志值，则此函数返回错误。

接口信息

函数/过程

OCINumberToInt 的语法如下：

sword OCINumberToInt ( OCIError              *err,
                       const OCINumber       *number,
                       uword                 rsl_length,
                       uword                 rsl_flag, 
                       void                  *rsl );

参数解释如下：

err(IN/OUT)：OCI 错误句柄。如果有错误，则记录在err中，并且该函数返回OCI_ERROR。通过调用 OCIErrorGet() 获取诊断信息。
number (IN)：要转换的OCINumber类型。
rsl_length(IN)：所需结果的大小。
rsl_flag(IN)：指定输出符号的标志，如下所示：
- OCI_NUMBER_UNSIGNED：无符号值。
- OCI_NUMBER_SIGNED：有符号值。
rsl(OUT)：指向结果空间的指针。

其他说明

无

OCINumberToReal

功能描述

转换OCINumber 为实数。

功能说明

此函数将 OCINumber 转换为系统原生的实数类型。此函数仅将 NUMBER 转换为精度为 LDBL_DIG、DBL_DIG 或 FLT_DIG 的数字，并删除尾随零。这些常量在 float.h 中定义。

用户必须将有效的 OCINumber 传递给此函数。否则结果是未定义的。

接口信息

函数/过程

OCINumberToReal 的语法如下：

sword OCINumberToReal ( OCIError            *err,
                        const OCINumber     *number,
                        uword                rsl_length,
                        void                *rsl );

参数解释如下：

err(IN/OUT)：OCI 错误句柄。如果有错误，则记录在err中，并且该函数返回OCI_ERROR。通过调用 OCIErrorGet() 获取诊断信息。
number (IN)：要转换的OCINumber类型。
rsl_length(IN)：所需结果的大小，等于 sizeof ( { float | double | long double } )。
rsl(OUT)：指向结果空间的指针。

其他说明

无

OCINumberFromReal

功能描述

将实数(浮点)类型转换为OCINumber。

功能说明

将实数(浮点)类型转换为OCINumber。您必须将有效的 OCINumber 传递给此函数。否则结果是未定义的。

接口信息

函数/过程

语法如下：

sword OCINumberFromReal ( OCIError  *err,  const void  *mum, uword mum_length, 
                          OCINumber  *number );

参数解释如下：

输入
- err(IN): OCI错误句柄。
- mum(IN): 指向要转换的浮点数的指针。
- mum_length(IN): 所需结果的大小，等于 sizeof ( {float | double | long double})。
- number(OUT): 给定浮点数转换为 OCINumber。
输出
- sword (OUT) : 函数是否成功执行。

其他说明

无

OCINumberPower

功能描述

将给定的基数提高到给定的指数。

功能说明

将给定的基数提高到给定的指数。

接口信息

函数/过程

语法如下：

sword
OCINumberPower(OCIError  *err,  const OCINumber *base,
const OCINumber  *number, OCINumber  *result)

参数解释如下：

err(IN/OUT)：错误句柄。若有错误就记录在err中，并且由该函数返回OCI_ERROR，调用OCIErrorGet()获得错误的诊断信息。
base(IN)：幂的基数。
number(IN)：基数要提高到的指数。
result(OUT)：幂的输出。

返回值：

如果任何 NUMBER 参数为 NULL，则此函数返回错误。

注意：

当前只支持到 double精度，long double的精度是达不到的，随机型类型不同 double 类型也是有所不同的。

其他说明

无

OCINumberPrec

功能描述

将OCINumber舍入为指定的十进制数字数。

功能说明

将OCINumber舍入为指定的十进制数字数。

接口信息

函数/过程

语法如下：

sword
OCINumberPrec(OCIError *err, const OCINumber *number,
swordnDigs,  OCINumber *result);

参数解释如下：

err(IN/OUT)：错误句柄。若有错误就记录在 err 中，并且由该函数返回 OCI_ERROR，调用OCIErrorGet()获得错误的诊断信息。
number(IN)：要为其设置精度的数字。
nDigs(IN)：结果中所需的十进制位数。
result(OUT)：结果。

返回值：

如果任何 NUMBER 参数为 NULL，则此函数返回错误。

其他说明

无

OCINumberRound

功能描述

将NUMBER舍入到指定的小数位。

功能说明

将NUMBER舍入到指定的小数位。

接口信息

函数/过程

语法如下：

sword
OCINumberRound(OCIError *err, const OCINumber *number,
sword decplace,  OCINumber *result);

参数解释如下：

err(IN/OUT)：错误句柄。若有错误就记录在 err 中，并且由该函数返回 OCI_ERROR，调用OCIErrorGet()获得错误的诊断信息。
number(IN)：NUMBER进行舍入。
decplace(IN)：要舍入到的小数点右侧的十进制位数。允许使用负值。
result(OUT)：结果。

返回值：

如果任何 NUMBER 参数为 NULL，则此函数返回错误。

其他说明

无

OCINumberSetPi

功能描述

将OCINumber设置为 pi。

功能说明

将OCINumber设置为 pi。

接口信息

函数/过程

语法如下：

void
OCINumberSetPi(OCIError *err, OCINumber *num)

参数解释如下：

err(IN/OUT)：错误句柄。若有错误就记录在 err 中，并且由该函数返回 OCI_ERROR，调用OCIErrorGet()获得错误的诊断信息。
num(OUT)：输出的结果。
result(OUT)：结果。

其他说明

无

OCINumberSetZero

功能描述

将NUMBER初始化为零。

功能说明

将NUMBER初始化为零。

接口信息

函数/过程

语法如下：

void
OCINumberSetZero(OCIError *err, OCINumber *num)

参数解释如下：

err(IN/OUT)：错误句柄。若有错误就记录在 err 中，并且由该函数返回 OCI_ERROR，调用OCIErrorGet()获得错误的诊断信息。
num(OUT)：输出的结果。

其他说明

无

OCINumberShift

功能描述

将NUNBER乘以10的幂，方法是将其移动指定的小数位数。

功能说明

将NUNBER乘以10的幂，方法是将其移动指定的小数位数。

接口信息

函数/过程

语法如下：

sword 
OCINumberShift ( OCIError   *err
const OCINumber    *number,
const sword     nDig,
OCINumber    *result )

参数解释如下：

err(IN/OUT)：错误句柄。若有错误就记录在 err 中，并且由该函数返回 OCI_ERROR，调用OCIErrorGet()获得错误的诊断信息。
number(IN)：输入的number。
nDig(IN)：要移动的小数位数。
result (IN)：输出的结果。

返回值：

如果任何 NUMBER参数为 NULL，则此函数返回错误。

其他说明

无

OCINumberSign

功能描述

获取 NUMBER 编号的符号。

功能说明

获取 NUMBER 编号的符号。

接口信息

函数/过程

语法如下：

sword 
OCINumberSign ( OCIError   *err
const OCINumber    *number,
sword    *result )

参数解释如下：

err(IN/OUT)：错误句柄。若有错误就记录在 err 中，并且由该函数返回 OCI_ERROR，调用OCIErrorGet()获得错误的诊断信息。
number(IN)：输入的number。
result (OUT)：输出的结果。

Value of NUMBER	Output in result Parameter
number < 0	-1
number == 0	0
number > 0	1

返回值：

如果任何 NUMBER参数为 NULL，则此函数返回错误。

其他说明

无

OCINumberSin

功能描述

计算NUMBER的正弦（以弧度为单位）。

功能说明

计算NUMBER的正弦（以弧度为单位）。

接口信息

函数/过程

语法如下：

sword OCINumberSin ( OCIError   *err, const OCINumber    *number,
OCINumber    *result );

参数解释如下：

err(IN/OUT)：错误句柄。若有错误就记录在 err 中，并且由该函数返回 OCI_ERROR，调用OCIErrorGet()获得错误的诊断信息。
number(IN)：输入的number。
result (OUT)：输出的结果。

返回值：

如果任一NUMBER参数为 NULL，则此函数返回错误。

注意：

当前只支持到 double精度，long double的精度是达不到的，随机型类型不同 double 类型也是有所不同的。

其他说明

无

OCINumberSgrt

功能描述

计算NUMBER的平方根。

功能说明

计算NUMBER的平方根。

接口信息

函数/过程

语法如下：

sword OCINumberSqrt ( OCIError   *err, const OCINumber    *number,
OCINumber    *result );

参数解释如下：

err(IN/OUT)：错误句柄。若有错误就记录在 err 中，并且由该函数返回 OCI_ERROR，调用OCIrrorGet()获得错误的诊断信息。
number(IN)：输入的number。
result (OUT)：包含输入NUMBER的平方根的输出。

返回值：

如果NUMBER为 NULL或 NUMBER 为负数，则此函数返回错误。

注意：

当前只支持到 double精度，long double的精度是达不到的，随机型类型不同double类型也是有所不同的。

其他说明

无

OCINumberExp

功能描述

将e提升到指定的NUMBER幂。

功能说明

将e提升到指定的NUMBER幂。

接口信息

函数/过程

语法如下：

sword OCINumberExp ( OCIError   *err, const OCINumber    *number,
OCINumber    *result );

参数解释如下：

err(IN/OUT)：错误句柄。若有错误就记录在 err 中，并且由该函数返回OCI_ERROR，调用OCIErrorGet()获得错误的诊断信息。
number(IN)：输入的number。
result (OUT)：输出结果。

返回值：

如果任何NUMBER参数为 NULL，则此函数返回错误。

注意：

当前只支持到 double精度，long double的精度是达不到的，随机型类型不同double类型也是有所不同的。

其他说明

无

OCINumberTan

功能描述

计算NUMBER的正切（以弧度为单位）。

功能说明

计算NUMBER的正切（以弧度为单位）。

接口信息

函数/过程

语法如下：

sword OCINumberTan ( OCIError   *err, const OCINumber    *number,
OCINumber    *result );

参数解释如下：

err(IN/OUT)：错误句柄。若有错误就记录在 err 中，并且由该函数返回 OCI_ERROR，调用OCIErrorGet()获得错误的诊断信息。
number(IN)：输入的number。
result (OUT)：输出结果。

返回值：

如果任何NUMBER参数为 NULL，则此函数返回错误。

注意：

当前只支持到 double精度，long double的精度是达不到的，随机型类型不同double类型也是有所不同的。

其他说明

无

OCINumberToRealArray

功能描述

将 NUMBER 数组转换为实数类型的数组。

功能说明

将 NUMBER 数组转换为实数类型的数组。

接口信息

函数/过程

语法如下：

sword OCINumberToRealArray( OCIError *err, const OCINumber  **number,
uword elems, uword rsl_length, void *rsl );

参数解释如下：

err(IN/OUT)：错误句柄。若有错误就记录在 err 中，并且由该函数返回 OCI_ERROR，调用OCIErrorGet()获得错误的诊断信息。
number(IN)：指向要转换的NUMBER数组的指针。
elems(IN)：最大NUMBER指针数。
rsl_length(IN)：所需结果的大小，即 sizeof ({float | double | long double})。
rs1(OUT)：指向用于存储结果的空间数组的指针。

返回值：

OCI_SUCCESS，如果函数成功完成；
OCI_INVALID_HANDLE，如果err为 NULL;
OCI_ERROR，如果NUMBER或rsl为NULL或rsl_length为0。

注意：

当前只支持到 double精度，long double的精度是达不到的，随机型类型不同double类型也是有所不同的。

其他说明

无

OCINumberTrunc

功能描述

在指定的小数位截断 NUMBER。

功能说明

在指定的小数位截断 NUMBER。

接口信息

函数/过程

语法如下：

sword OCINumberTrunc( OCIError  *err ,const OCINumber  *number,
sword decplace, OCINumber *result );

参数解释如下：

err(IN/OUT)：错误句柄。若有错误就记录在 err 中，并且由该函数返回 OCI_ERROR，调用OCIErrorGet()获得错误的诊断信息。
number(IN)：指向要转换的NUMBER数组的指针。
decplace(IN)：要截断的小数点右侧的十进制位数。允许使用负值。
result (OUT)：输出结果。

返回值：

如果任一NUMBER参数为NULL，则此函数返回错误。

其他说明

无

OCINumberIntPower

功能描述

将给定的基数提高到给定的整数幂。

功能说明

将给定的基数提高到给定的整数幂。

接口信息

函数/过程

语法如下：

sword OCINumberIntPower(  OCIError  *err, const OCINumber  *base,
const sword exp, OCINumber  *result )

参数解释如下：

err(IN/OUT)：错误句柄。若有错误就记录在 err 中，并且由该函数返回 OCI_ERROR，调用OCIErrorGet()获得错误的诊断信息。
number(IN)：幂的基数。
exp(IN)：基数提高到的指数。
result (OUT)：输出结果。

返回值：

如果任一NUMBER参数为NULL，则此函数返回错误。

注意：

当前只支持到 double精度，long double的精度是达不到的，随机型类型不同double类型也是有所不同的。

其他说明

无

OCINumberMod

功能描述

获取两个NUMBER的除法的模(余数）。

功能说明

获取两个NUMBER的除法的模(余数）。

接口信息

函数/过程

语法如下：

sword OCINumberMod(  OCIError  *err, const OCINumber  *number1,
const OCINumber  *number2,  OCINumber *result );

参数解释如下：

err(IN/OUT)：错误句柄。若有错误就记录在 err 中，并且由该函数返回 OCI_ERROR，调用OCIErrorGet()获得错误的诊断信息。
numberl(IN)：指向分子的指针。
number2(IN)：指向分母的指针。
result (OUT)：输出结果。

返回值：

如果NUMBER 1或NUMBER 2为 NULL，或者存在除以零错误，则此函数将返回错误。

注意：

当前只支持到 double精度，long double的精度是达不到的，随机型类型不同 double 类型也是有所不同的。

其他说明

无

OCINumberLn

功能描述

取NUMBER的自然对数(以e为底）。

功能说明

取NUMBER的自然对数(以e为底）。

接口信息

函数/过程

语法如下：

sword OCINumberLn( OCIError  *err,  const OCINumber  *number,
OCINumber   *result );

参数解释如下：

err(IN/OUT)：错误句柄。若有错误就记录在 err 中，并且由该函数返回 OCI_ERROR，调用OCIErrorGet()获得错误的诊断信息。
number(IN)：计算此NUMBER的对数。
result (OUT)：输出结果。

返回值：

如果NUMBER参数为NULL，或者NUMBER小于或等于零，则此函数将返回错误。

注意：

当前只支持到 double精度，long double的精度是达不到的，随机型类型不同 double 类型也是有所不同的。

其他说明

无

OCINumberNeg

功能描述

NUMBER类型取反。

功能说明

NUMBER类型取反。

接口信息

函数/过程

语法如下：

sword OCINumberNeg( OCIError  *err, const OCINumber  *number,
OCINumber  *result );

参数解释如下：

err(IN/OUT)：错误句柄。若有错误就记录在 err 中，并且由该函数返回 OCI_ERROR，调用OCIErrorGet()获得错误的诊断信息。
number(IN)：计算此NUMBER的反值。
result (OUT)：输出结果。

返回值：

如果NUMBER参数为NULL，或者NUMBER小于或等于零，则此函数将返回错误。

其他说明

无

OCINumberAbs

功能描述

计算给定NUMBER的绝对值。

功能说明

计算给定NUMBER的绝对值。

接口信息

函数/过程

语法如下：

sword OCINumberAbs (  OCIError   *err,
const OCINumber  *number,
OCINumber    *result );

参数解释如下：

err(IN/OUT)：错误句柄。若有错误就记录在 err 中，并且由该函数返回 OCI_ERROR，调用OCIErrorGet()获得错误的诊断信息。
number(IN)：输入的number。
result (OUT)：输入的number的绝对值。

返回值：

如果NUMBER参数为NULL，则此函数将返回错误。

注意：

当前只支持到 double精度，long double的精度是达不到的，随机型类型不同double类型也是有所不同的。

其他说明

无

OCINumberAdd

功能描述

计算给定两个NUMBER的和。

功能说明

计算给定两个NUMBER的和。

接口信息

函数/过程

语法如下：

sword OCINumberAdd( OCIError    *err,
const OCINumber   *number1,
const OCINumber   *number2,
OCINumber   *result );

参数解释如下：

err(IN/OUT)：错误句柄。若有错误就记录在 err 中，并且由该函数返回 OCI_ERROR，调用OCIErrorGet()获得错误的诊断信息。
number1(IN)：被加数。
number2(IN)：加数。
result (OUT)：和的输出。

返回值：

如果任何NUMBER参数为NULL，则此函数将返回错误。

注意：

当前只支持到 double精度，long double的精度是达不到的，随机型类型不同double类型也是有所不同的。

其他说明

无

OCINumberArcCos

功能描述

计算给定NUMBER的反余弦。

功能说明

计算给定NUMBER的反余弦。

接口信息

函数/过程

语法如下：

sword OCINumberArcCos ( OCIError  *err,
const OCINumber   *number,
OCINumber   *result );

参数解释如下：

err(IN/OUT)：错误句柄。若有错误就记录在 err 中，并且由该函数返回 OCI_ERROR，调用OCIErrorGet()获得错误的诊断信息。
number(IN)：需要被计算反余弦值的number。
result (OUT)：反余弦的输出。

返回值：

如果任何NUMBER参数为NULL，则此函数将返回错误。

注意：

当前只支持到 double精度，long double的精度是达不到的，随机型类型不同double类型也是有所不同的。

其他说明

无

OCINumberArcSin

功能描述

计算给定NUMBER的反正弦。

功能说明

计算给定NUMBER的反正弦。

接口信息

函数/过程

语法如下：

sword OCINumberArcSin ( OCIError  *err,
const OCINumber   *number,
OCINumber   *result );

参数解释如下：

err(IN/OUT)：错误句柄。若有错误就记录在 err 中，并且由该函数返回 OCI_ERROR，调用OCIErrorGet()获得错误的诊断信息。
number(IN)：需要被计算反正弦值的number。
result (OUT)：反正弦的输出。

返回值：

如果任何NUMBER参数为NULL，则此函数将返回错误。

注意：

当前只支持到 double精度，long double的精度是达不到的，随机型类型不同double类型也是有所不同的。

其他说明

无

OCINumberArcTan

功能描述

计算给定NUMBER的反正切。

功能说明

计算给定NUMBER的反正切。

接口信息

函数/过程

语法如下：

sword OCINumberArcTan ( OCIError  *err,
const OCINumber   *number,
OCINumber   *result );

参数解释如下：

err(IN/OUT)：错误句柄。若有错误就记录在 err 中，并且由该函数返回 OCI_ERROR，调用OCIErrorGet()获得错误的诊断信息。
number(IN)：需要被计算反正切值的number。
result (OUT)：反正切的输出。

返回值：

如果任何NUMBER参数为NULL，则此函数将返回错误。

注意：

当前只支持到 double精度，long double的精度是达不到的，随机型类型不同double类型也是有所不同的。

其他说明

无

OCINumberArcTan2

功能描述

给定两个NUMBER计算反正切。

功能说明

给定两个NUMBER计算反正切。

接口信息

函数/过程

语法如下：

sword OCINumberArcTan2 ( OCIError  *err,
const OCINumber   *number1,
const OCINumber   *number2,
OCINumber   *result );

参数解释如下：

err(IN/OUT)：错误句柄。若有错误就记录在 err 中，并且由该函数返回 OCI_ERROR，调用OCIErrorGet()获得错误的诊断信息。
number1(IN)：反正切的参数1。
number2(IN)：反正切的参数2。
result (OUT)：反正切的输出。

返回值：

如果任何NUMBER参数为NULL，则此函数将返回错误。

注意：

当前只支持到 double精度，long double的精度是达不到的，随机型类型不同double类型也是有所不同的。

其他说明

无

OCINumberAssign

功能描述

将一个number复制给另一个number。

功能说明

将一个number复制给另一个number。

接口信息

函数/过程

语法如下：

sword OCINumberAssign ( OCIError  *err,
const OCINumber   *from,
OCINumber   *to );

参数解释如下：

err(IN/OUT)：错误句柄。若有错误就记录在 err 中，并且由该函数返回 OCI_ERROR，调用OCIErrorGet()获得错误的诊断信息。
from(IN)：被复制的number。
to (OUT)：需要被复制到的number。

返回值：

如果任何NUMBER参数为NULL，则此函数将返回错误。

其他说明

无

OCINumberCeil

功能描述

计算给定number的上限值。

功能说明

计算给定number的上限值。

接口信息

函数/过程

语法如下：

sword OCINumberCeil ( OCIError  *err,
const OCINumber   *number,
OCINumber   *result );

参数解释如下：

err(IN/OUT)：错误句柄。若有错误就记录在 err 中，并且由该函数返回 OCI_ERROR，调用OCIErrorGet()获得错误的诊断信息。
number(IN)：输入的number。
result (OUT)：包含输入number的上限值的输出。

返回值：

如果任何NUMBER参数为NULL，则此函数将返回错误。

其他说明

无

OCINumberCmp

功能描述

将两个number进行比较。

功能说明

将两个number进行比较。

接口信息

函数/过程

语法如下：

sword OCINumberCmp ( OCIError  *err,
const OCINumber   *number1,
const OCINumber   *number2,
OCINumber   *result );

参数解释如下：

err(IN/OUT)：错误句柄。若有错误就记录在 err 中，并且由该函数返回 OCI_ERROR，调用OCIErrorGet()获得错误的诊断信息。
number1(IN),number2(IN)：将number1与number2进行比较。
result (OUT)：比价的结果输出。

返回值：

如果任何NUMBER参数为NULL，则此函数将返回错误。

注意：

当前只支持到 double精度，long double的精度是达不到的，随机型类型不同double类型也是有所不同的。

由于oracle的number结构和oci的number结构设计有区别，此接口只进行了结果的正负号对齐，对输出的数值未做对齐。

其他说明

无

OCINumberCos

功能描述

计算给定number的余弦。

功能说明

计算给定number的余弦。

接口信息

函数/过程

语法如下：

sword OCINumberCos ( OCIError  *err,
const OCINumber   *number,
OCINumber   *result );

参数解释如下：

err(IN/OUT)：错误句柄。若有错误就记录在 err 中，并且由该函数返回 OCI_ERROR，调用OCIErrorGet()获得错误的诊断信息。
number(IN)：需要计算余弦的number。
result (OUT)：余弦值输出。

返回值：

如果任何NUMBER参数为NULL，则此函数将返回错误。

注意：

当前只支持到 double精度，long double的精度是达不到的，随机型类型不同double类型也是有所不同的。

其他说明

无

OCINumberDec

功能描述

将给定的number递减1。

功能说明

将给定的number递减1。

接口信息

函数/过程

语法如下：

sword OCINumberDec ( OCIError  *err,
OCINumber   *number);

参数解释如下：

err(IN/OUT)：错误句柄。若有错误就记录在 err 中，并且由该函数返回 OCI_ERROR，调用OCIErrorGet()获得错误的诊断信息。
number(IN/OUT)：需要递减的number。

返回值：

如果任何NUMBER参数为NULL，则此函数将返回错误。

注意：

当前只支持到 double精度，long double的精度是达不到的，随机型类型不同double类型也是有所不同的。

其他说明

无

OCINumberDiv

功能描述

计算两个number相除的值。

功能说明

计算两个number相除的值。

接口信息

函数/过程

语法如下：

sword OCINumberDiv ( OCIError  *err,
const OCINumber   *number1,
const OCINumber   *number2,
OCINumber             *result);

参数解释如下：

err(IN/OUT)：错误句柄。若有错误就记录在 err 中，并且由该函数返回 OCI_ERROR，调用OCIErrorGet()获得错误的诊断信息。
number1(IN)：被除数。
number2(IN)：除数。
result(OUT)：相除的值。

返回值：

如果任何NUMBER参数为NULL，则此函数将返回错误。

注意：

当前只支持到 double精度，long double的精度是达不到的，随机型类型不同double类型也是有所不同的。在除数为 0的时候，报错时的数值与oracle有精度区别。

其他说明

无

OCINumberSub

功能描述

计算两个number相减的值。

功能说明

计算两个number相减的值。

接口信息

函数/过程

语法如下：

sword OCINumberSub ( OCIError  *err,
const OCINumber   *number1,
const OCINumber   *number2,
OCINumber             *result);

参数解释如下：

err(IN/OUT)：错误句柄。若有错误就记录在 err 中，并且由该函数返回 OCI_ERROR，调用OCIErrorGet()获得错误的诊断信息。
number1(IN)：被减数。
number2(IN)：减数。
result(OUT)：相减的值。

返回值：

如果任何NUMBER参数为NULL，则此函数将返回错误。

注意：

当前只支持到 double精度，long double的精度是达不到的，随机型类型不同double类型也是有所不同的。

其他说明

无

OCINumberInc

功能描述

将给定的number递增1。

功能说明

将给定的number递增1。

接口信息

函数/过程

语法如下：

sword OCINumberInc ( OCIError  *err,
OCINumber   *number);

参数解释如下：

err(IN/OUT)：错误句柄。若有错误就记录在 err 中，并且由该函数返回 OCI_ERROR，调用OCIErrorGet()获得错误的诊断信息。
number(IN/OUT)：需要递增的number。

返回值：

如果任何NUMBER参数为NULL，则此函数将返回错误。

注意：

当前只支持到 double精度，long double的精度是达不到的，随机型类型不同double类型也是有所不同的。

其他说明

无

OCINumberLog

功能描述

取 Oracle NUMBER的对数(任意基数)。

功能说明

取 Oracle NUMBER的对数(任意基数)。

接口信息

函数/过程

语法如下：

sword OCINumberLog ( OCIError    *err,
const OCINumber   *base,
const OCINumber    *number,
OCINumber           *result );

参数解释如下：

err(IN/OUT)：错误句柄。若有错误就记录在 err 中，并且由该函数返回 OCI_ERROR，调用OCIErrorGet()获得错误的诊断信息。
base(IN)：log 的底数。
number(IN)：指数。
result(OUT)：log的输出。

返回值：

如果任何NUMBER参数为NULL，则此函数将返回错误。

注意：

当前只支持到 double精度，long double的精度是达不到的，随机型类型不同double类型也是有所不同的。如果以1为指数，将会返回 0x7fffffffffffffffLL。

其他说明

无

OCINumberlsZero

功能描述

判断NUMBER是否为0。

功能说明

判断NUMBER是否为0。

接口信息

函数/过程

语法如下：

sword OCINumberIsZero( OCIError    *err,
const OCINumber    *number,
boolean           *result );

参数解释如下：

err(IN/OUT)：错误句柄。若有错误就记录在 err 中，并且由该函数返回 OCI_ERROR，调用OCIErrorGet()获得错误的诊断信息。
number(IN)：需要判断是否是0的number。
result(OUT)：输出。

返回值：

如果任何NUMBER参数为NULL，则此函数将返回错误。

注意：

当前只支持到 double精度，long double的精度是达不到的，随机型类型不同double类型也是有所不同的。

其他说明

无

OCINumberMul

功能描述

计算两个NUMBER相乘的值。

功能说明

计算两个NUMBER相乘的值。

接口信息

函数/过程

语法如下：

sword OCINumberMul( OCIError    *err,
const OCINumber    *number1,
const OCINumber    *number2,
OCINumber          *result );

参数解释如下：

err(IN/OUT)：错误句柄。若有错误就记录在 err 中，并且由该函数返回 OCI_ERROR，调用OCIErrorGet()获得错误的诊断信息。
number1(IN)：被乘数。
number2(IN)：乘数。
result(OUT)：积的输出。

返回值：

如果任何NUMBER参数为NULL，则此函数将返回错误。

注意：

当前只支持到 double精度，long double的精度是达不到的，随机型类型不同double类型也是有所不同的。

其他说明

无

OCINumberHypSin

功能描述

计算NUMBER的双曲正弦值。

功能说明

计算NUMBER的双曲正弦值。

接口信息

函数/过程

语法如下：

sword OCINumberHypSin( OCIError    *err,
const OCINumber    *number,
OCINumber          *result );

参数解释如下：

err(IN/OUT)：错误句柄。若有错误就记录在 err 中，并且由该函数返回 OCI_ERROR，调用OCIErrorGet()获得错误的诊断信息。
number(IN)：输入的number。
result(OUT)：输出的结果。

返回值：

如果 NUMBER 参数之一为 NULL，则此函数返回错误。

注意：

当前只支持到科学计数法前五位精度。

其他说明

无

OCINumberHypTan

功能描述

计算NUMBER的双曲正切值。

功能说明

计算NUMBER的双曲正切值。

接口信息

函数/过程

语法如下：

sword OCINumberHypTan( OCIError    *err,
const OCINumber    *number,
OCINumber          *result );

参数解释如下：

err(IN/OUT)：错误句柄。若有错误就记录在 err 中，并且由该函数返回 OCI_ERROR，调用OCIErrorGet()获得错误的诊断信息。
number(IN)：输入的number。
result(OUT)：输出的结果。

返回值：

如果 NUMBER 参数之一为 NULL，则此函数返回错误。

注意：

当前只支持到科学计数法前五位精度。

其他说明

无

OCINumberHypCos

功能描述

计算NUMBER的双曲余弦值。

功能说明

计算NUMBER的双曲余弦值。

接口信息

函数/过程

语法如下：

sword OCINumberHypCos( OCIError    *err,
const OCINumber    *number,
OCINumber          *result );

参数解释如下：

err(IN/OUT)：错误句柄。若有错误就记录在 err 中，并且由该函数返回 OCI_ERROR，调用OCIErrorGet()获得错误的诊断信息。
number(IN)：输入的number。
result(OUT)：输出的结果。

返回值：

如果 NUMBER 参数之一为 NULL，则此函数返回错误。

注意：

当前只支持到科学计数法前五位精度。

其他说明

无

OCINumberFromlnt

功能描述

将整数转换为Oracle NUMBER。

功能说明

将整数转换为Oracle NUMBER。

接口信息

函数/过程

语法如下：

sword OCINumberFromInt( OCIError    *err,
const void    *inum,
uword            inum_length,
uword            inum_s_flag,
OCINumber   *number);

参数解释如下：

err(IN/OUT)：错误句柄。若有错误就记录在 err 中，并且由该函数返回 OCI_ERROR，调用OCIErrorGet()获得错误的诊断信息。
inum(IN)：指向要转换的整数的指针。
inum_length (IN)：整数的大小。
inum_s_flag (IN)：指定整数符号的标志，如下所示：
- OCI_NUMBER_UNSIGNED-无符号值
- OCI_NUMBER_SIGNED-有符号值
number(OUT)：给定的整数转换为 NUMBER。

返回值：

如果任一NUMBER参数 NULL，则此函数返回错误。

注意：如果数字太大以至于无法放入 NUMBER 中，如果数字或 inum 为NULL，或者如果在inum_s_Flag 中传递了无效的符号标志值，则此函数将返回错误。

其他说明

无

OCINumberFloor

功能描述

计算 NUMBER 的最低(四舍五入)值。

功能说明

计算 NUMBER 的最低(四舍五入)值。

接口信息

函数/过程

语法如下：

sword OCINumberFloor( OCIError    *err,
const OCINumber   *number,
OCINumber   *result);

参数解释如下：

err(IN/OUT)：错误句柄。若有错误就记录在 err 中，并且由该函数返回 OCI_ERROR，调用OCIErrorGet()获得错误的诊断信息。
number(IN)：输入的 NUMBER。
result(OUT)：输出的结果。

返回值：

如果任一NUMBER 参数为 NULL，则此函数返回错误。

其他说明

无

VastbaseG100

Number类型接口

OCINumberFromText

功能描述

功能说明

接口信息

其他说明

OCINumberToText

功能描述

功能说明

接口信息

其他说明

OCINumberIsInt

功能描述

功能说明

接口信息

其他说明

OCINumberToInt

功能描述

功能说明

接口信息

其他说明

OCINumberToReal

功能描述

功能说明

接口信息

其他说明

OCINumberFromReal

功能描述

功能说明

接口信息

其他说明

OCINumberPower

功能描述

功能说明

接口信息

其他说明

OCINumberPrec

功能描述

功能说明

接口信息

其他说明

OCINumberRound

功能描述

功能说明

接口信息

其他说明

OCINumberSetPi

功能描述

功能说明

接口信息

其他说明

OCINumberSetZero

功能描述

功能说明

接口信息

其他说明

OCINumberShift

功能描述

功能说明

接口信息

其他说明

OCINumberSign

功能描述

功能说明

接口信息

其他说明

OCINumberSin

功能描述

功能说明

接口信息

其他说明

OCINumberSgrt

功能描述

功能说明

接口信息

其他说明

OCINumberExp

功能描述

功能说明