ITPub博客

首页 > 数据库 > 国内数据库 > YashanDB SUBSTR函数

YashanDB SUBSTR函数

国内数据库 作者:崖山数据库系统YashanDB 时间:2025-08-01 15:58:22 0 删除 编辑

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
代码
substr::= SUBSTR "(" expr "," pos ["," len] ")"

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


来自 “ ITPUB博客 ” ,链接:https://blog.itpub.net/70028812/viewspace-3092605/ ,如需转载,请注明出处,否则将追究法律责任。

上一篇: YashanDB STRPOS函数
请登录后发表评论 登录
全部评论
崖山数据库系统YashanDB是深圳计算科学研究院完全自主研发设计的新型数据库系统,融入原创理论,支持单机/主备、共享集群、分布式等多种部署方式,覆盖OLTP/HTAP/OLAP交易和分析混合负载场景,为客户提供一站式的企业级融合数据管理解决方案。

注册时间:2023-04-11

  • 博文量
    722
  • 访问量
    639747