すべてのプロダクト
Search
ドキュメントセンター

MaxCompute:RTRIM

最終更新日:Jan 17, 2025

文字列の右側から文字を削除します。

使用上の注意

現在、RTRIM関数は英字のみをサポートしています。

構文

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

パラメーター

この関数は、strで指定された文字列の右側から文字を削除するために使用されます。

  • trimCharsを指定しない場合、右側のスペースはデフォルトで削除されます。

  • trimCharsを指定した場合、trimCharsで指定された1つ以上の文字で構成される部分文字列は、strで指定された文字列の右側から削除されます。

  • str: 必須です。 STRING型の値。 このパラメータは、文字が削除される右側の文字列を指定します。 入力値がBIGINT、DECIMAL、DOUBLE、またはDATETIME型の場合、入力値は計算前に暗黙的にSTRING型の値に変換されます。

  • trimChars: オプション。 STRING型の値。 削除する文字を指定します。 入力値がBIGINT、DECIMAL、DOUBLE、またはDATETIME型の場合、入力値は計算前に暗黙的にSTRING型の値に変換されます。

戻り値

STRING型の値が返されます。 戻り値は、次のルールによって異なります。

  • strの値がSTRING型でない場合、または暗黙的にSTRING型の値に変換できない場合、エラーが返されます。

  • strまたはtrimCharsの値がnullの場合、nullが返されます。

例:

  • 例1: 文字列yxTxyomxxの右側からスペースを削除します。 例:

    -- The return value is  yxTxyomxx. 
    select rtrim(' yxTxyomxx ');
    -- The preceding statement is equivalent to the following statement: 
    select trim(trailing from ' yxTxyomxx ');
  • 例2: xyコレクション内の1つ以上の文字で構成される部分文字列を、文字列yxTxyomxxの右側から削除します。

    -- The return value is yxTxyom. If x or y appears on the right side of a string, it is removed. 
    select rtrim('yxTxyomxx', 'xy');
    -- The preceding statement is equivalent to the following statement: 
    select trim(trailing 'xy' from 'yxTxyomxx');
  • 例3: 入力パラメーターがnullに設定されています。 例:

    -- The return value is null. 
    select rtrim(null);
    select trim('yxTxyomxx', null);

関連関数

RTRIMは文字列関数です。 文字列検索と変換に関連する関数の詳細については、文字列関数.