文档

RTRIM

更新时间:

去除字符串的右端字符。

注意事项

当前仅英文字符串支持RTRIM去除字符命令。

命令格式

string rtrim(string <str>[, <trimChars>])
string trim(trailing [<trimChars>] from <str>)

参数说明

str的右端去除字符:

  • 如果未指定trimChars,则默认去除空格字符。

  • 如果指定了trimChars,则以trimChars中包含的字符作为一个集合,从str的右端去除尽可能长的所有字符都在集合trimChars中的子串。

  • str:必填。STRING类型。待去除右端字符的字符串。如果输入为BIGINT、DECIMAL、DOUBLE或DATETIME等类型,则会隐式转换为STRING类型后参与运算。

  • trimChars:可选。String类型。待去除的字符。如果输入为BIGINT、DECIMAL、DOUBLE或DATETIME等类型,则会隐式转换为STRING类型后参与运算。

返回值说明

返回为STRING类型。返回规则如下:

  • str为非STRING或不支持隐式转换为STRING的类型时,返回报错。

  • strtrimChars值为NULL时,返回NULL。

使用示例

  • 示例1:去除字符串 yxTxyomxx 的右边空格。命令示例如下。

    --返回字符串 yxTxyomxx。
    select rtrim(' yxTxyomxx ');
    --等效于如下语句。
    select trim(trailing from ' yxTxyomxx ');
  • 示例2:去除字符串yxTxyomxx右端所有字符都在集合xy中的子串。

    --返回yxTxyom,只要右端遇到x或者y就会被去掉。
    select rtrim('yxTxyomxx', 'xy');
    --等效于如下语句。
    select trim(trailing 'xy' from 'yxTxyomxx');
  • 示例3:输入参数为NULL。命令示例如下。

    --返回NULL。
    select rtrim(null);
    select trim('yxTxyomxx', null);

相关函数

RTRIM函数属于字符串函数,更多查找字符串、转换字符串格式的相关函数请参见字符串函数