TRIM関数は、文字列から先行文字または後続文字(あるいはその両方)を削除します。
SQL構文
TRIMには、次の4つの有効な構文オプションがあります。
Trim_character
と組み合せてTRIM修飾子の1つ(LEADING、TRAILINGまたはBOTH)を指定します。
TRIM ( LEADING|TRAILING|BOTHTrim_character
FROMExpression
)
Trim_character
なしでTRIM修飾子の1つ(LEADING、TRAILINGまたはBOTH)を指定します。
TRIM ( LEADING|TRAILING|BOTH FROM Expression
)
TRIM修飾子なしでTrim_character
を指定します。
TRIM (Trim_character
FROMExpression
)
修飾子またはTrim_character
なしでExpression
を指定します。
TRIM ( Expression
)
パラメータ
TRIMには、次のパラメータがあります。
パラメータ | 説明 |
---|---|
TRIM (
LEADING | TRAILING | BOTH [ FROM
|
LEADING、TRAILINGまたはBOTHは、TRIM関数の修飾子です。LEADINGは、Expression からTrim_character のすべての先行文字を削除します。TRAILINGは、Expression からTrim_character のすべての後続文字を削除します。BOTHは、Expression からTrim_character の先行文字と後続文字を削除します。
FROMは必須です。
|
TRIM (
FROM
|
Expression からTrim_character の先行文字と後続文字の両方を削除します。
FROMは
|
TRIM (
|
(修飾子またはTrim_character なしで)Expression を指定すると、Expression から先行および後続の空白文字が削除されます。
|
説明
LEADING修飾子を指定すると、TRIMにより、Expression
からTrim_character
に等しいすべての先行文字が削除されます。
TRAILING修飾子を指定すると、TRIMにより、Expression
からTrim_character
に等しいすべての後続文字が削除されます。
BOTH修飾子を指定するか、修飾子を何も指定しないと、TRIMにより、Expression
からTrim_character
に等しい先行文字と後続文字が削除されます。
Expression
のみを指定すると、TRIMにより、先行および後続の空白文字が削除されます。
Expression
がCHARまたはVARCHAR2型の場合、戻されるデータ型はVARCHAR2です。 Expression
がNCHARまたはNVARCHAR2型の場合、戻されるデータ型はNVARCHAR2です。戻されるデータ型の長さは、Expression
のデータ型の長さに等しくなります。
Expression
が文字長セマンティクスで定義されたデータ型の場合、戻される長さは文字長セマンティクスで表現されます。
Trim_character
またはExpression
のいずれかがNULLの場合、結果はNULLです。
Trim_character
とExpression
には、TT_CHAR、TT_VARCHAR、TT_NCHARおよびTT_NVARCHARを指定できます。Expression
がTT_CHARまたはTT_VARCHAR型の場合、戻されるデータ型はTT_VARCHARです。 Expression
がTT_NCHARまたはTT_NVARCHAR型の場合、戻されるデータ型はTT_NVARCHARです。
Trim_character
がNCHARまたはNVARCHAR2型で、Expression
がCHARまたはVARCHAR2型の場合、Trim_character
はTRIMの実行前にCHARまたはVARCHAR2に変換されます。Trim_character
の変換は失われる可能性があります。 Trim_character
がデータベースのキャラクタ・セットに含まれない場合、問合せにより予期しない結果が発生する可能性があります。
CHAR、VARCHAR2、NCHARおよびNVARCHAR2型の場合:
Expression
のすべての文字がTRIM関数により削除された場合、結果はNULLになります。
TT_CHAR、TT_VARCHAR、TT_NCHARおよびTT_NVARCHAR型の場合:
Expression
のすべての文字がTRIM関数により削除された場合、結果は空の文字列になります。
例
TRIM関数を修飾子とともに使用し、Expression
の0000TRIM Example0000からTrim_character
の0(ゼロ)を削除します。
Command> SELECT TRIM (LEADING '0' FROM '0000TRIM Example0000') FROM dual; < TRIM Example0000 > 1 row found. Command> SELECT TRIM (TRAILING '0' FROM '0000TRIM Example0000') FROM dual; < 0000TRIM Example > 1 row found. Command> SELECT TRIM (BOTH '0' FROM '0000TRIM Example0000') FROM dual; < TRIM Example > 1 row found.
TRIM関数を修飾子とともに使用し、空白文字を削除します。 Trim_character
は指定しません。 Trim_character
のデフォルト値は、空白文字です。
Command> SELECT TRIM (LEADING FROM ' TRIM Example ') FROM dual; < TRIM Example > 1 row found. Command> SELECT TRIM (TRAILING FROM ' TRIM Example ') FROM dual; < TRIM Example > 1 row found. Command> SELECT TRIM (BOTH FROM ' TRIM Example ') FROM dual; < TRIM Example > 1 row found.
TRIM関数をTrim_character
の0(ゼロ)とともに使用します。修飾子は指定しません。 Expression
の0000TRIM Example0000から、先行および後続の0(ゼロ)が削除されます。
Command> SELECT TRIM ('0' FROM '0000TRIM Example0000') FROM dual; < TRIM Example > 1 row found.
TRIM関数を修飾子またはTrim_character
なしで使用します。先行および後続の空白文字が削除されます。
< TRIM Example > 1 row found. Command> SELECT TRIM (' TRIM Example ') FROM dual;