RTRIM

RTRIM関数は、Expression1の右端から、Expression2に含まれるすべての文字を削除します。TimesTenでは、Expression1の最後の文字から逆方向にスキャンが開始され、Expression2に存在しない文字に到達するまでExpression2で指定した文字がすべて削除されて、結果が戻されます。

SQL構文

RTRIM (Expression1 [,Expression2])

パラメータ

RTRIMには、次のパラメータがあります。

パラメータ説明

パラメータ	説明
`Expression1`	切捨ての対象とする`CHAR`、`VARCHAR2`、`NCHAR`、`NVARCHAR2`、`CLOB`、`NCLOB`オペランドまたは列。`Expression1`が文字リテラルの場合は、その文字リテラルを引用符で囲みます。
`Expression2`	`Expression1`の切捨てに使用するオプションの式。`Expression2`が文字リテラルの場合は、その文字リテラルを一重引用符で囲みます。`Expression2`を指定しないと、単一の空白文字がデフォルト設定されます。オペランドまたは列には、`CHAR`、`VARCHAR2`、`NCHAR`、`NVARCHAR2`、`CLOB`または`NCLOB`型を指定できます。

Expression1

切捨ての対象とするCHAR、VARCHAR2、NCHAR、NVARCHAR2、CLOB、NCLOBオペランドまたは列。Expression1が文字リテラルの場合は、その文字リテラルを引用符で囲みます。

Expression2

Expression1の切捨てに使用するオプションの式。Expression2が文字リテラルの場合は、その文字リテラルを一重引用符で囲みます。Expression2を指定しないと、単一の空白文字がデフォルト設定されます。オペランドまたは列には、CHAR、VARCHAR2、NCHAR、NVARCHAR2、CLOBまたはNCLOB型を指定できます。

説明

Expression1がCHAR型またはVARCHAR2型の場合、戻されるデータ型はVARCHAR2です。Expression1がNCHAR型またはNVARCHAR2型の場合、戻されるデータ型はNVARCHAR2です。Expression1がCLOBまたはNCLOBの場合、戻されるデータ型は指定されたLOBデータ型と同じになります。戻されるデータ型の長さは、Expression1のデータ型の長さと等しくなります。
Expression1がCHAR長セマンティクスで定義されたデータ型の場合、戻される長さはCHAR長セマンティクスで表現されます。
Expression1とExpression2のどちらかがNULLの場合、結果はNULLになります。
Expression1とExpression2には、TT_CHAR、TT_VARCHAR、TT_NCHARおよびTT_NVARCHARを指定できます。Expression1がTT_CHAR型またはTT_VARCHAR型の場合、戻されるデータ型はTT_VARCHARです。Expression1がTT_NCHAR型またはTT_NVARCHAR型の場合、戻されるデータ型はTT_NVARCHARです。
Expression1がCHAR型またはVARCHAR2型で、Expression2がNCHAR型またはNVARCHAR2型の場合、Expression2はRTRIMの実行前にCHARまたはVARCHAR2に変換されます。Expression2の変換は失われる可能性があります。Expression2の切捨て文字がデータベース文字セットに含まれていないと、この問合せにより予期しない結果が発生する可能性があります。
CHAR、VARCHAR2、NCHAR、NVARCHAR2、CLOBおよびNCLOB型の場合:
- RTRIM関数によってExpression1のすべての文字が削除された場合、結果はNULLになります。
TT_CHAR、TT_VARCHAR、TT_NCHARおよびTT_NVARCHAR型の場合:
- RTRIM関数によってExpression1のすべての文字が削除された場合、結果は空の文字列になります。

例

次の例では、表rtrimtestのcol1から後続の空白を削除します。

Command> CREATE TABLE rtrimtest (col1 VARCHAR2 (25));
Command> INSERT INTO rtrimtest VALUES ('abc     ');
1 row inserted.
Command> SELECT * FROM rtrimtest;
< abc      >
1 row found.
Command> SELECT RTRIM (col1) FROM rtrimtest;
< abc >
1 row found.

RTRIM関数をコールして、右端の'x'および'y'を文字列から削除します。RTRIMは、'xy'というパターンではなく、個々に出現する'x'と'y'を削除します。

Command> SELECT RTRIM ('RTRIM Examplexxxyyyxyxy', 'xy') FROM dual;
< RTRIM Example >
1 row found.

RTRIMをコールして、Expression1からすべての文字を削除します。最初の例では、データ型がCHARであるため、NULLが戻されます。2番目の例では、データ型がTT_CHARであるため、空の文字列が戻されます。

Command> CREATE TABLE rtrimtest (col1 CHAR (4), col2 TT_CHAR (4));
Command> INSERT INTO rtrimtest VALUES ('BBBA', 'BBBA');
1 row inserted.
Command> SELECT RTRIM (col1, 'AB') FROM rtrimtest;
< <NULL> >
1 row found.
Command> SELECT RTRIM (col2, 'AB') FROM rtrimtest;
<  >
1 row found.