写点什么

YashanDB SUBSTRB 函数

作者:YashanDB
  • 2025-08-04
    广东
  • 本文字数:1937 字

    阅读完需:约 6 分钟

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) dFROM 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)) dFROM DUAL;A B C D--------- ----- --------- ---------b b bc bc
复制代码

代码

substrb::= SUBSTRB "(" expr "," pos ["," len] ")"
复制代码

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) dFROM 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)) dFROM DUAL;A B C D--------- ----- --------- ---------b b bc bc
复制代码


用户头像

YashanDB

关注

全自研国产新型大数据管理系统 2022-02-15 加入

还未添加个人简介

评论

发布
暂无评论
YashanDB SUBSTRB函数_数据库 大数据_YashanDB_InfoQ写作社区