依照分隔符separator拆分字符串str,返回从start部分到end部分的子串(闭区间)。
命令格式
string split_part(string <str>, string <separator>, bigint <start>[, bigint <end>])
参数说明
str:必填。STRING类型。待拆分的字符串。如果是BIGINT、DOUBLE、DECIMAL或DATETIME类型,则会隐式转换为STRING类型后参与运算。
separator:必填。STRING类型常量。拆分用的分隔符,可以是一个字符,也可以是一个字符串。
start:必填。BIGINT类型常量,必须大于0。表示返回段的开始编号(从1开始)。
end:BIGINT类型常量,大于等于start。表示返回段的截止编号,可省略,缺省时表示和start取值相等,返回start指定的段。
返回值说明
返回STRING类型。返回规则如下:
如果start的值大于切分后实际的分段数,例如字符串拆分完有6个片段,start大于6,返回空串。
如果separator不存在于str中,且start指定为1,返回整个str。如果str为空串,则输出空串。
如果separator为空串,则返回原字符串str。
如果end大于片段个数,返回从start开始的子串。
str非STRING、BIGINT、DOUBLE、DECIMAL或DATETIME类型时,返回报错。
separator非STRING类型常量时,返回报错。
start或end非BIGINT类型常量时,返回报错。
除separator外,如果任一参数值为NULL,返回NULL。
使用示例
示例1:依照分隔符
,
拆分字符串a,b,c,d
,返回指定部分的子串。命令示例如下。--返回a。 select split_part('a,b,c,d', ',', 1); --返回a,b。 select split_part('a,b,c,d', ',', 1, 2);
示例2:start的值大于切分后实际的分段数。命令示例如下。
--返回空串。 select split_part('a,b,c,d', ',', 10);
示例3:separator不存在于str中。命令示例如下。
--返回a,b,c,d。 select split_part('a,b,c,d', ':', 1); --返回空串。 select split_part('a,b,c,d', ':', 2);
示例4:separator为空串。命令示例如下。
--返回a,b,c,d。 select split_part('a,b,c,d', '', 1);
示例5:end的值大于切分后实际的分段数。命令示例如下。
--返回b,c,d。 select split_part('a,b,c,d', ',', 2, 6);
示例6:除separator外,任一输入参数为NULL。命令示例如下。
--返回NULL。 select split_part('a,b,c,d', ',', null);
相关函数
SPLIT_PART函数属于字符串函数,更多查找字符串、转换字符串格式的相关函数请参见字符串函数。