YashanDB SUBSTRB 函数
SUBSTRB
语法图

SUBSTRB 函数提取expr表示的字符串里指定位置和指定字节长度的子字符串。
本函数不支持向量化计算。
expr
expr 的值须为字符型,或可转换为字符型的其他类型,但不能为 XMLTYPE、NCLOB 类型。
当 expr 的值为 NULL 时,函数返回 NULL。
当 expr 的值为 RAW 类型时,返回值为 RAW 类型。当 expr 值为 NCHAR、NVARCHAR 类型时,返回值为 NVARCHAR 类型。当 expr 值为其他类型时,返回值为 VARCHAR 类型。
expr 不支持 32000 字节以上的 LOB 类型数据。
pos
表示从 pos 值指定位置开始提取字符串,pos 为与 expr 相同的通用表达式。pos 值须为除 BIT 外数值型数据,或可转换为 NUMBER 的其他类型数据,取值范围[-2147483648,2147483647]。当 pos 值为正数时,表示从前往后确定起始位置,当 pos 值为负数时,表示从后向前确定起始位置。
当其值为带有小数的 NUMBER 类型(或转换后为 NUMBER 类型)时,函数截断其小数位保留整数位。
当其值为浮点类型时,函数将其奇进偶舍至整数。
当 pos 的值为 NULL 时,函数返回 NULL。
当 pos 值为 0 时,等同于 1。
当 pos 绝对值超过字符串的长度时,函数返回 NULL。
len
表示提取 len 值指定字节长度的字符串,len 为与 expr 相同的通用表达式,len 值须为除 BIT 外数值型数据,或可转换为 NUMBER 的其他类型数据,取值范围[-2147483648,2147483647]。
当不指定 len,或 len 值大于从 pos 值指定位置开始到字符串结尾的长度时,函数返回从 pos 值指定位置开始到字符串结尾的子字符串。
当其值为带有小数的 NUMBER 类型(或转换后为 NUMBER 类型)时,函数截断其小数位保留整数位。
当其值为浮点类型时,函数将其奇进偶舍至整数。
当 len 的值为 NULL 时,函数返回 NULL。
当 len 为 0 或负数时,函数返回 NULL。
示例(HEAP 表)
代码
SUBSTRB 函数提取expr表示的字符串里指定位置和指定字节长度的子字符串。
本函数不支持向量化计算。
expr
expr 的值须为字符型,或可转换为字符型的其他类型,但不能为 XMLTYPE、NCLOB 类型。
当 expr 的值为 NULL 时,函数返回 NULL。
当 expr 的值为 RAW 类型时,返回值为 RAW 类型。当 expr 值为 NCHAR、NVARCHAR 类型时,返回值为 NVARCHAR 类型。当 expr 值为其他类型时,返回值为 VARCHAR 类型。
expr 不支持 32000 字节以上的 LOB 类型数据。
pos
表示从 pos 值指定位置开始提取字符串,pos 为与 expr 相同的通用表达式。pos 值须为除 BIT 外数值型数据,或可转换为 NUMBER 的其他类型数据,取值范围[-2147483648,2147483647]。当 pos 值为正数时,表示从前往后确定起始位置,当 pos 值为负数时,表示从后向前确定起始位置。
当其值为带有小数的 NUMBER 类型(或转换后为 NUMBER 类型)时,函数截断其小数位保留整数位。
当其值为浮点类型时,函数将其奇进偶舍至整数。
当 pos 的值为 NULL 时,函数返回 NULL。
当 pos 值为 0 时,等同于 1。
当 pos 绝对值超过字符串的长度时,函数返回 NULL。
len
表示提取 len 值指定字节长度的字符串,len 为与 expr 相同的通用表达式,len 值须为除 BIT 外数值型数据,或可转换为 NUMBER 的其他类型数据,取值范围[-2147483648,2147483647]。
当不指定 len,或 len 值大于从 pos 值指定位置开始到字符串结尾的长度时,函数返回从 pos 值指定位置开始到字符串结尾的子字符串。
当其值为带有小数的 NUMBER 类型(或转换后为 NUMBER 类型)时,函数截断其小数位保留整数位。
当其值为浮点类型时,函数将其奇进偶舍至整数。
当 len 的值为 NULL 时,函数返回 NULL。
当 len 为 0 或负数时,函数返回 NULL。
示例(HEAP 表)
评论