YashanDB SUBSTRING 函数
SUBSTRING
语法图

SUBSTRING 函数提取expr表示的字符串中指定位置指定长度的子字符串。
expr
expr 的值须为字符型,或可转换为字符型的其他类型。
当 expr 的值为 NULL 时,函数返回 NULL。
当 expr 的值为 CLOB 类型时,返回值为 CLOB 类型;当 expr 的值为 NCLOB 类型时,返回值为 NCLOB 类型;当 expr 值为 NCHAR、NVARCHAR 类型时,返回值为 NVARCHAR 类型;当 expr 值为其他类型时,返回值为 VARCHAR 类型。
对于列存表中的 LOB 类型字段,若某行数据为行外存储,则无法使用本函数。
expr 不能为 XMLTYPE 类型。
pos
表示从 pos 值指定位置开始提取字符串,pos 为与 expr 相同的通用表达式,须为除 BIT 外数值型数据,或可转换为 NUMBER 的其他类型数据,取值范围[-2147483648,2147483647]。
当 pos 的值为带有小数的 NUMBER 类型(或转换后为 NUMBER 类型)时,函数四舍五入进行取整。
当 pos 的值为浮点类型时,函数将其奇进偶舍至整数。
当 pos 的值为 NULL 时,函数返回 NULL。
当 pos 的值为正数时,表示从字符串的头部开始确定起始位置;当 pos 值为负数时,表示从字符串的尾部开始确定起始位置。
当 pos 的值等于 0 或其绝对值超过字符串的长度时,函数返回 NULL。
len
表示提取 len 值指定长度的字符串,len 为与 expr 相同的通用表达式,须为除 BIT 外数值型数据,或可转换为 NUMBER 的其他类型数据,取值范围[-2147483648,2147483647]。
当 len 的值为带有小数的 NUMBER 类型(或转换后为 NUMBER 类型)时,函数四舍五入进行取整。
当 len 的值为浮点类型时,函数将其奇进偶舍至整数。
当 len 的值为 NULL 时,函数返回 NULL。
当不指定 len,或 len 值大于从 pos 值指定位置开始到字符串结尾的长度时,函数返回从 pos 值指定位置开始到字符串结尾的子字符串。
当 len 的值为 0 或负数时, 函数返回 NULL。
示例
代码
SUBSTRING 函数提取expr表示的字符串中指定位置指定长度的子字符串。
expr
expr 的值须为字符型,或可转换为字符型的其他类型。
当 expr 的值为 NULL 时,函数返回 NULL。
当 expr 的值为 CLOB 类型时,返回值为 CLOB 类型;当 expr 的值为 NCLOB 类型时,返回值为 NCLOB 类型;当 expr 值为 NCHAR、NVARCHAR 类型时,返回值为 NVARCHAR 类型;当 expr 值为其他类型时,返回值为 VARCHAR 类型。
对于列存表中的 LOB 类型字段,若某行数据为行外存储,则无法使用本函数。
expr 不能为 XMLTYPE 类型。
pos
表示从 pos 值指定位置开始提取字符串,pos 为与 expr 相同的通用表达式,须为除 BIT 外数值型数据,或可转换为 NUMBER 的其他类型数据,取值范围[-2147483648,2147483647]。
当 pos 的值为带有小数的 NUMBER 类型(或转换后为 NUMBER 类型)时,函数四舍五入进行取整。
当 pos 的值为浮点类型时,函数将其奇进偶舍至整数。
当 pos 的值为 NULL 时,函数返回 NULL。
当 pos 的值为正数时,表示从字符串的头部开始确定起始位置;当 pos 值为负数时,表示从字符串的尾部开始确定起始位置。
当 pos 的值等于 0 或其绝对值超过字符串的长度时,函数返回 NULL。
len
表示提取 len 值指定长度的字符串,len 为与 expr 相同的通用表达式,须为除 BIT 外数值型数据,或可转换为 NUMBER 的其他类型数据,取值范围[-2147483648,2147483647]。
当 len 的值为带有小数的 NUMBER 类型(或转换后为 NUMBER 类型)时,函数四舍五入进行取整。
当 len 的值为浮点类型时,函数将其奇进偶舍至整数。
当 len 的值为 NULL 时,函数返回 NULL。
当不指定 len,或 len 值大于从 pos 值指定位置开始到字符串结尾的长度时,函数返回从 pos 值指定位置开始到字符串结尾的子字符串。
当 len 的值为 0 或负数时, 函数返回 NULL。
示例
评论