logo - 跳到首页

VastbaseG100

基于openGauss内核开发的企业级关系型数据库。

Menu

Interval类型接口

OCIIntervalFromText

功能描述

给定一个字符串，将其转换成OCIInterval类型。

功能说明

根据给定字符串的格式，识别为year and month或者day and second类型的Interval，然后将其构造成一个OCIInterval，格式不正确时则报错处理。

接口信息

函数/过程

OCIIntervalFromText 语法如下：

sword OCIIntervalFromText ( void           *hndl, 
                         OCIError       *err, 
                         const OraText  *inpstring,
                         size_t         str_len,
                         OCIInterval    *result )

具体参数解释如下：

  • hndl：以对象模式初始化的 OCI 环境句柄。
  • err：OCI错误句柄。
  • inpstring：待转换的字符串。
  • str_len：字符串的长度。
  • result：转换后的OCIInterval对象。

其他说明

无

OCIIntervalFromNumber

功能描述

给定一个OCINumber，将其转换成OCIInterval类型。

功能说明

该根据给定的OCINumber，根据一定的转换规则转换成year and month或者day and second的Interval，超出能表示范围则进行报错处理。

数据相关性

无

接口信息

函数/过程

OCIIntervalFromNumber 语法如下：

sword OCIIntervalFromNumber ( void               *hndl, 
                            OCIError           *err,
                            OCIInterval        *interval,
                            OCINumber          *number );

参数的解释如下：

  • hndl：以对象模式初始化的 OCI 环境句柄。
  • err：OCI错误句柄。
  • number ：待转换的OCINumber。
  • interval：转换后的OCIInterval对象。

其他说明

无

OCIIntervalToText

功能描述

将给定的OCIInterval类型转换成字符串。

功能说明

根据给定的OCIInterval，拼接成字符串后返回。需注意的是前后的精度设置，如果位数不足则补零处理。

数据相关性

无

接口信息

函数/过程

OCIIntervalToText 语法如下：

sword OCIIntervalToText ( void               *hndl,
                       OCIError           *err,
                       const OCIInterval  *interval,
                       ub1                lfprec,
                       ub1                fsprec,
                       OraText            *buffer, 
                       size_t             buflen,
                       size_t             *resultlen );

参数的解释如下：

  • hndl：以对象模式初始化的 OCI 环境句柄。
  • err：OCI错误句柄。
  • interval：待转换的OCIInterval。
  • lfprec：前精度，用于表示前导字段的位数。
  • fsprec：小数秒精度，用于表示小数秒的位数。
  • buflen：buffer的最大长度。
  • buffer：用于存储转换后字符串的buffer。
  • resultlen ：buffer的实际长度。

其他说明

无

OCIIntervalToNumber

功能描述

将给定的OCIInterval类型转换成OCINumber类型。

功能说明

根据给定的OCIInterval，按照number转interval的转换规则，逆向转换为number，并构造成一个OCINumber后返回。

数据相关性

无

接口信息

函数/过程

OCIIntervalToNumber 语法如下：

sword OCIIntervalToNumber ( void               *hndl, 
                         OCIError           *err,
                         OCIInterval        *interval,
                         OCINumber          *number );

参数的解释如下：

  • hndl：以对象模式初始化的 OCI 环境句柄。
  • err：OCI错误句柄。
  • interval：待转换的OCIInterval。
  • number：转换后的OCINumber。

其他说明

无

OCIIntervalAssign

功能描述

复制一个OCIInterval到另一个OCIInterval。

功能说明

直接将给定的OCIInterval赋值给另一个OCIInterval即可。如果类型不匹配则报错处理。

数据相关性

无

接口信息

函数/过程

OCIIntervalAssign 语法如下：

void OCIIntervalAssign ( void              *hndl, 
                     OCIError          *err, 
                     const OCIInterval *inpinter, 
                     OCIInterval       *outinter );

参数的解释如下：

  • hndl：以对象模式初始化的 OCI 环境句柄。
  • err：OCI错误句柄。
  • inpinter：待拷贝的OCIInterval。
  • outinter ：拷贝后的OCIInterval。

其他说明

无

OCIIntervalCheck

功能描述

检查给定的OCIInterval是否合法和有效。

功能说明

根据给定的OCIInterval类型，对每一个成员进行检查，如果成员的值不合法则报错并赋予相应的错误码。

数据相关性

无

接口信息

函数/过程

OCIIntervalCheck 语法如下：

sword OCIIntervalCheck ( void               *hndl,
                      OCIError            *err,
                      const OCIInterval   *interval,
                      ub4                 *valid );

参数的解释如下：

  • hndl：以对象模式初始化的 OCI 环境句柄。
  • err：OCI错误句柄。
  • interval：待检查的OCIInterval。
  • valid：检查结果，0或者错误码。

其他说明

无

OCIIntervalCompare

功能描述

比较两个OCIInterval，如果interval1大于interval2则返回1，如果interval1小于interval2则返回-1，相等则返回0。

功能说明

比较两个OCIInterval，比较的顺序为：如果是year and month类型则是年、月；如果是day and second类型则分别为天、时、分、秒、秒的小数部分。

数据相关性

无

接口信息

函数/过程

OCIIntervalCompare 语法如下：

sword OCIIntervalCompare (void          *hndl, 
                        OCIError      *err,
                        OCIInterval   *inter1, 
                        OCIInterval   *inter2, 
                        sword         *result );

参数的解释如下：

  • hndl：以对象模式初始化的 OCI 环境句柄。
  • err：OCI错误句柄。
  • inter1：待比较的OCIInterval 1。
  • inter2：待比较的OCIInterval 2。
  • result：比较结果。

其他说明

无

OCIIntervalAdd

功能描述

将两个OCIInterval相加并将结果存储到新的OCIInterval后返回。

功能说明

将两个OCIInterval相加，如果当前单位的值超出可表示范围则进位到前一个单位。类型不兼容则报错处理。

数据相关性

无

接口信息

函数/过程

OCIIntervalAdd 语法如下：

sword OCIIntervalAdd ( void         *hndl, 
                    OCIError     *err, 
                    OCIInterval  *addend1, 
                    OCIInterval  *addend2, 
                    OCIInterval  *result );

参数的解释如下：

  • hndl：以对象模式初始化的 OCI 环境句柄
  • err：OCI错误句柄
  • addend1：待相加的OCIInterval 1
  • addend2：待相加的OCIInterval 2
  • result ：相加后的结果

其他说明

无

OCIIntervalSubtract

功能描述

将两个OCIInterval相减并将结果存储到新的OCIInterval后返回。

功能说明

将两个OCIInterval按类型相减，如果类型不兼容则报错处理。

数据相关性

无

接口信息

函数/过程

OCIIntervalSubtract 语法如下：

sword OCIIntervalSubtract ( void         *hndl,
                        OCIError     *err, 
                        OCIInterval  *minuend, 
                        OCIInterval  *subtrahend,
                        OCIInterval  *result );

参数的解释如下：

  • hndl：以对象模式初始化的 OCI 环境句柄。
  • err：OCI错误句柄。
  • minuend：被减数OCIInterval。
  • subtrahend：减数OCIInterval。
  • result：相减结果。

其他说明

无

OCIIntervalMultiply

功能描述

将OCIInterval乘以一个OCINumber，并将结果存储到新的OCIInterval后返回。

功能说明

将OCIInterval乘以一个OCINumber，如果当前单位的值超出可表示范围则进位到前一个单位。类型不兼容则报错处理。

数据相关性

无

接口信息

函数/过程

OCIIntervalMultiply 语法如下：

sword OCIIntervalMultiply ( void               *hndl, 
                        OCIError           *err, 
                        const OCIInterval  *inter,
                        OCINumber          *nfactor,
                        OCIInterval        *result );

参数的解释如下：

  • hndl：以对象模式初始化的 OCI 环境句柄。
  • err：OCI错误句柄。
  • inter：待相乘的OCIInterval。
  • nfactor：待相乘的OCINumber。
  • result：相乘结果。

其他说明

无

OCIIntervalDivide

功能描述

将OCIInterval除以一个OCINumber，并将结果存储到新的OCIInterval后返回。

功能说明

将OCIInterval除以OCINumber，如果类型不兼容则报错处理。

数据相关性

无

接口信息

函数/过程

OCIIntervalDivide 语法如下：

sword OCIIntervalDivide ( void         *hndl, 
                      OCIError     *err, 
                      OCIInterval  *dividend, 
                      OCINumber    *divisor, 
                      OCIInterval  *result );

参数的解释如下：

  • hndl：以对象模式初始化的 OCI 环境句柄。
  • err：OCI错误句柄。
  • dividend：被除数OCIInterval。
  • divisor：除数OCINumber。
  • result：相除结果。

其他说明

无

OCIIntervalSetYearMonth

功能描述

设置年和月到一个OCIInterval。

功能说明

将OCIInterval中的year和month赋值为给定的year和month。如果类型为day and second则进行报错处理。

数据相关性

无

接口信息

函数/过程

OCIIntervalSetYearMonth 语法如下：

sword OCIIntervalSetYearMonth ( void               *hndl, 
                            OCIError           *err, 
                            sb4                yr,
                            sb4                mnth,
                            OCIInterval        *result );

参数的解释如下：

  • hndl：以对象模式初始化的 OCI 环境句柄。
  • err：OCI错误句柄。
  • yr：待设置的年。
  • mnth：待设置的月。
  • result：设置后的OCIInterval。

其他说明

无

OCIIntervalSetYearMonth

功能描述

设置年和月到一个OCIInterval。

功能说明

将OCIInterval中的day、hour、minute和second设置为给定的day、hour、minute和second。如果类型为year and month则进行报错处理。

数据相关性

无

接口信息

函数/过程

OCIIntervalSetYearMonth 语法如下：

sword OCIIntervalSetYearMonth ( void               *hndl, 
                            OCIError           *err, 
                            sb4                yr,
                            sb4                mnth,
                            OCIInterval        *result );

参数的解释如下：

  • hndl：以对象模式初始化的 OCI 环境句柄。
  • err：OCI错误句柄。
  • yr：待设置的年。
  • mnth：待设置的月。
  • result：设置后的OCIInterval。

其他说明

无

OCIIntervalGetYearMonth

功能描述

从一个OCIInterval中获取年和月。

功能说明

返回OCIInterval结构中的year和month，如果类型为day and second则进行报错处理。

数据相关性

无

接口信息

函数/过程

OCIIntervalGetYearMonth 语法如下：

sword OCIIntervalGetYearMonth ( void               *hndl, 
                            OCIError           *err, 
                            sb4                *yr,
                            sb4                *mnth,
                            const OCIInterval  *interval );

参数的解释如下：

  • hndl：以对象模式初始化的 OCI 环境句柄。
  • err：OCI错误句柄。
  • interval：源OCIInterval。
  • yr：获取后的年。
  • mnth：获取后的月。

其他说明

无

OCIIntervalGetDaySecond

功能描述

从一个OCIInterval中获取天、时、分、秒。

功能说明

返回OCIInterval中的day、hour、minute、second和秒的小数部分。如果类型为year and month则进行报错处理。

数据相关性

无

接口信息

函数/过程

OCIIntervalGetDaySecond 语法如下：

sword OCIIntervalGetDaySecond (void               *hndl, 
                            OCIError           *err, 
                            sb4                *dy, 
                            sb4                *hr,
                            sb4                *mm, 
                            sb4                *ss, 
                            sb4                *fsec, 
                            const OCIInterval  *interval );

参数的解释如下：

  • hndl：以对象模式初始化的 OCI 环境句柄
  • err：OCI错误句柄
  • interval：源OCIInterval
  • dy：获取后的天
  • hr：获取后的时
  • mm：获取后的分
  • ss：获取后的秒
  • fsec：获取后的秒小数位

其他说明

无

OClIntervalFromTZ

功能描述

返回数据类型为 OCIInterval 的 OCI_DTYPE_INTERVAL_DS，其中区域ID集（如果在输入字符串中指定了区域）和当前绝对偏移量，或返回区域ID 设置为0的绝对偏移量。

功能说明

返回数据类型为 OCIInterval 的 OCI_DTYPE_INTERVAL_DS，其中区域ID集（如果在输入字符串中指定了区域）和当前绝对偏移量，或返回区域ID 设置为0的绝对偏移量。

数据相关性

无

接口信息

函数/过程

语法如下：

sword OCIIntervalFromTZ(  void *hndl, OCIError *err, const oratext *inpstring
                          size_t str_len, OCIInterwal *result );

参数的解释如下：

  • 输入

    • Hndl：用户会话句柄或环境句柄。

    • Err：错误句柄。

    • Inpstring：指向输入字符串的指针，格式为[+-JTZH：TZM (TZH：0-15；TZM：0-59，注意在TZH为 15时TZM只能为 0)和 OCI保持一致。

    • str_len：输入字符串的长度。

  • 输出

    • result：输出的间隔类型(只支持OCI_DTYPE_INIERVAL_DS)和OCI保持一致。

其他说明

无