去除字符串的右端字符。

命令格式

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类型。待去除的字符。

返回值说明

返回为STRING类型。返回规则如下：
  • str非STRING、BIGINT、DOUBLE、DECIMAL或DATETIME类型时，返回报错。
  • str或trimChars值为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 ltrim('yxTxyomxx', 'null');