YashanDB SUBSTR 函数

SUBSTR 函数提取expr表示的字符串里指定位置和指定长度的子字符串。

本函数遵循如下规则：

expr

expr 的值须为字符型，或可转换为字符型的其他类型，但不能为 XMLTYPE 类型。

• 当 expr 的值为 NULL 时，函数返回 NULL。

• 当 expr 的值为 CLOB 类型时，返回值为 CLOB 类型；当 expr 的值为 NCLOB 类型时，返回值为 NCLOB 类型；当 expr 的值为 NCHAR/NVARCHAR 类型时，返回值为 NVARCHAR 类型；当 expr 值为其他类型时，返回值为 VARCHAR 类型。

• 对于列存表中的 LOB 类型字段，若某行数据为行外存储，则无法使用本函数。

pos

表示从 pos 值指定位置开始提取字符串，pos 值须为除 BIT 外数值型数据，或可转换为 NUMBER 的其他类型数据，取值范围[-2147483648,2147483647]。

• 当其值为带有小数的 NUMBER 类型（或转换后为 NUMBER 类型）时，函数截断其小数位保留整数位。

• 当其值为浮点类型时，函数将其奇进偶舍至整数。

• pos 为与 expr 相同的通用表达式，当 pos 的值为 NULL 时，函数返回 NULL。

• 当 pos 值为正数时，表示从字符串的头部开始确定起始位置；当 pos 值为负数时，表示从字符串的尾部开始确定起始位置；当 pos 值为 0 时，等同于 1。

• 当 pos 绝对值超过字符串的长度时，函数返回 NULL。

len

表示提取 len 值指定长度的字符串，len 值须为除 BIT 外数值型数据，或可转换为 NUMBER 的其他类型数据，取值范围[-2147483648,2147483647]。

• 当其值为带有小数的 NUMBER 类型（或转换后为 NUMBER 类型）时，函数截断其小数位保留整数位。

• 当其值为浮点类型时，函数将其奇进偶舍至整数。

• len 为与 expr 相同的通用表达式，当 len 的值为 NULL 时，函数返回 NULL。

• 当不指定 len，或 len 值大于从 pos 值指定位置开始到字符串结尾的长度时，函数返回从 pos 值指定位置开始到字符串结尾的子字符串。

• 当 len 为 0 或负数时，函数返回 NULL。

示例

SELECT SUBSTR('abcdefg', 3) a,SUBSTR('abcdefg', 3, 2) b,SUBSTR('abcdefg', -3) c,SUBSTR('abcdefg', 3, -2) dFROM DUAL;A         B     C     D    --------- ----- ----- -----cdefg     cd    efg SELECT SUBSTR('abcdefg', CAST(2.5 AS NUMBER), CAST(1.5 AS NUMBER)) a,SUBSTR('abcdefg', '2.5', '1.5') b,SUBSTR('abcdefg', CAST(2.5 AS FLOAT), CAST(1.5 AS FLOAT)) c,SUBSTR('abcdefg', CAST(2.5 AS DOUBLE), CAST(1.5 AS DOUBLE)) dFROM DUAL;A         B     C         D--------- ----- --------- ---------b         b     bc        bc