#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表）

SELECT SUBSTRB('中abc国', 4) a
,SUBSTRB('中abc国', 3, 4) b
,SUBSTRB('中abc国', -3) c
,SUBSTRB('中abc国', 3, -4) d
FROM DUAL;

A             B     C             D
------------- ----- ------------- -----
abc国         abc  国

 
SELECT SUBSTRB('abcdefg', CAST(2.5 AS NUMBER), CAST(1.5 AS NUMBER)) a
,SUBSTRB('abcdefg', '2.5', '1.5') b
,SUBSTRB('abcdefg', CAST(2.5 AS FLOAT), CAST(1.5 AS FLOAT)) c
,SUBSTRB('abcdefg', CAST(2.5 AS DOUBLE), CAST(1.5 AS DOUBLE)) d
FROM DUAL;
A         B     C         D
--------- ----- --------- ---------
b         b     bc        bc