全部產品
Search
文件中心

MaxCompute:TRIM

更新時間:Feb 28, 2024

去除字串的左右兩端字元。

注意事項

當前僅英文字串支援TRIM去除字元命令。

命令格式

string trim(string <str>[,<trimChars>])
string trim([BOTH] [<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類型時,返回報錯。

  • strtrimChars值為NULL時,返回NULL。

使用樣本

  • 樣本1:去除字串 yxTxyomxx 的左右空格。命令樣本如下。

    --返回字串yxTxyomxx。
    select trim(' yxTxyomxx ');
    --等效於如下語句。
    select trim(both from ' yxTxyomxx ');
    select trim(from ' yxTxyomxx ');
  • 樣本2:去除字串yxTxyomxx左右兩端所有字元都在集合xy中的子串。

    --返回Txyom,只要左右兩端遇到x或者y就會被去掉。
    select trim('yxTxyomxx', 'xy');
    --等效於如下語句。
    select trim(both 'xy' from 'yxTxyomxx');
    select trim('xy' from 'yxTxyomxx');
  • 樣本3:輸入參數為NULL。命令樣本如下。

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

相關函數

TRIM函數屬於字串函數,更多尋找字串、轉換字串格式的相關函數請參見字串函數