RTRIM スカラー関数

スキーマは SYSIBM です。

RTRIM 関数は、string-expression の末尾から、trim-expression に含まれるすべての文字を除去します。 検索は、trim-expression に含まれる各文字のバイナリー表現 (1 つ以上のバイトで構成される) を string-expression の末尾にあるバイトと比較することによって行われます。 string-expression が FOR BIT DATA として定義される場合、検索は、trim-expression に含まれる各バイトを string-expression の末尾にあるバイトと比較することによって行われます。

文字列式

ソース・ストリングを指定する式。 引数は、LOB ではない組み込みストリング・データ・タイプの値、または数値データ・タイプの値を返す式でなければなりません。 ストリング・データ・タイプでない値は、関数の評価の前に VARCHAR に暗黙的にキャストされます。 string-expression が FOR BIT DATA でない場合、trim-expression を FOR BIT DATA にすることはできません。

トリム式

string-expression の末尾から除去する文字を指定する式。 この式は、LOB ではない組み込みストリング・データ・タイプ、または数値データ・タイプの値を返す必要があります。 ストリング・データ・タイプでない値は、関数の評価の前に VARCHAR に暗黙的にキャストされます。

trim-expression のデフォルトは、string-expression のデータ・タイプによって異なります。

• string-expression が DBCS グラフィック・ストリングであれば DBCS のブランク。 ASCII の場合、DBCS のブランクを表す 16 進値は、CCSID によって決まります。 例えば、日本語 (CCSID 301) の場合は X'8140' が DBCS のブランクを表し、中国語 (簡体字) の場合は X'A1A1' が DBCS のブランクを表します。 EBCDIC の場合は X'4040' が DBCS のブランクを表します。
• 文字列表現がUnicodeグラフィック文字列の場合、 UTF-16 または UCS-2 のブランク （X'0020' ）。
• 文字列式がバイナリ文字列の場合、値は X'00' です。
• それ以外の場合は、1 バイトのブランク。 EBCDIC の場合は、X'40' がブランクを示します。 EBCDIC でない場合は、X'20' がブランクを表します。

string-expression と trim-expression は互換性のあるデータ・タイプを持つ必要があります。 string-expression と trim-expression の CCSID セットが異なる場合、trim-expression の CCSID は string-expression の CCSID に変換されます。

関数の結果は、string-expression のデータ・タイプによって決まります。

• string-expression が文字ストリングであれば VARCHAR。 string-expression が FOR BIT DATA として定義されている場合、結果は FOR BIT DATA です。
• string-expression がグラフィックであれば VARGRAPHIC。
• string-expression がバイナリー・ストリングであれば VARBINARY。

結果の長さ属性は、string-expression の長さ属性と同じになります。

文字ストリングまたはバイナリー・ストリングの場合、結果の実際の長さは、除去されるバイト数を string-expression から引いた長さになります。 グラフィック・ストリングである場合、結果の実際の長さは、除去される 2 バイト文字の数を string-expression から引いた長さ (2 バイト文字単位) になります。 すべての文字が除去された場合、結果は空ストリング (長さゼロ) です。

結果はnullになる可能性があります。引数がnullの場合、結果もnull値となります。

結果の CCSID は string-expression の CCSID と同じです。