タスクフロー

前へ次へ

rtrim

文字列の末尾から空白文字または文字を削除します。

式でtrim_set
パラメータを指定しない場合、rtrimは文字列の末尾からシングルバイトスペースとダブルバイトスペースを削除します。

rtrimを使って文字列から文字を削除する場合、rtrimはtrim_set
をstring
引数内の各文字と右から1文字ずつ比較します。文字列内の文字がtrim_set
内のいずれかの文字と一致した場合、rtrimはその文字を削除します。rtrimは、一致する文字がtrim_set
で見つからなくなるまで、文字を比較して削除します。一致する文字を含まない文字列を返します。

構文

sff:rtrim(str, trim_set)

次の表に、引数を示します。

引数	必須/ オプション	説明
string	必須	任意の文字列値。切り詰めを行う値を渡します。任意の有効なトランスフｫーメーション式を入力できます。文字列の末尾から空白文字を削除する前に、演算子を使って文字列の比較や連結を実行します。文字列値は一重引用符または二重引用符で囲む必要があります。 NULL値を渡すには、次の形式で空のシーケンスを指定する必要があります: ()
trim_set	オプション	任意の文字列値。文字列の末尾から削除を行う文字を渡します。文字列リテラルを入力することもできます。文字列値は一重引用符または二重引用符で囲む必要があります。 NULL値を渡すには、次の形式で空のシーケンスを指定する必要があります: () rtrim関数では大文字と小文字が区別されます。例えば、文字列'Alfredo'から'o'という文字を削除する場合は、'O'ではなく'o'と入力します。

戻り値

文字列。trim_set
引数で指定された文字を削除した結果の文字列値。

rtrimに渡される値がNULLの場合はNULL。trim_set
がNULLの場合、rtrimはNULLを返します。

例

次の式は、LAST_NAMEカラムの文字列から文字‘re’を削除します。

sff:rtrim( LAST_NAME, 're')

次の表に、一部のサンプル値と戻り値を示します。

LAST_NAME	RETURN VALUE
Nelson	Nelson
Page	Pag
Osborne	Osborn
NULL	NULL
Sawyer	Sawy
H. Bender	H. Bend
Steadman	Steadman

trim_set
の最初の文字は‘r’ですが、rtrim関数はPageから‘e’を削除します。これは、rtrimはtrim_set
引数に指定された文字列を1文字ずつ検索していくためです。文字列内の最後の文字がtrim_set
内の最初の文字と一致した場合、rtrimはその文字を削除します。ただし、文字列内の最後の文字が一致しない場合、rtrimはtrim_set
内の2番目の文字と比較します。文字列内の最後から2番目の文字がtrim_set
の2番目の文字と一致した場合、rtrimはその文字を削除します。文字列内の文字がtrim_set
と一致しなかった場合、rtrimはその文字列を返して、次の行の評価を行います。

最後の例では、Nelsonの最後の文字がtrim_set
引数のどの文字にも一致しないため、rtrimは'Nelson'を返して次の行を評価します。