TRIM
TRIM関数は、文字列から先行文字または後続文字(あるいはその両方)を削除します。
SQL構文
TRIMには、次の4つの有効な構文オプションがあります。
- Trim_characterと組み合せてTRIM修飾子の1つ(LEADING、TRAILINGまたはBOTH)を指定します。
TRIM ( LEADING|TRAILING|BOTH Trim_character FROM Expression )
- Trim_characterなしでTRIM修飾子の1つ(LEADING、TRAILINGまたはBOTH)を指定します。
TRIM ( LEADING|TRAILING|BOTH FROM Expression )
- TRIM修飾子なしでTrim_characterを指定します。
TRIM (Trim_character FROM Expression )
- 修飾子またはTrim_characterなしでExpressionを指定します。
TRIM ( Expression )
パラメータ
TRIMには、次のパラメータがあります。
パラメータ | 説明 |
TRIM ( LEADING | TRAILING | BOTH [Trim_ character] FROM Expression ) | LEADING、TRAILINGまたはBOTHは、TRIM関数の修飾子です。LEADINGは、ExpressionからTrim_characterのすべての先行文字を削除します。TRAILINGは、ExpressionからTrim_characterのすべての後続文字を削除します。BOTHは、ExpressionからTrim_characterの先行文字と後続文字を削除します。 Trim_characterはオプションです。指定する場合、この値はExpressionから切り捨てるCHAR、VARCHAR2、NCHAR、NVARCHAR2オペランドまたは列を表します。1つの文字のみを指定できます。Trim_characterを指定しない場合、デフォルトで単一の空白文字に設定されます。Trim_characterが文字リテラルの場合、一重引用符でその文字を囲みます。 FROMは必須です。 Expressionは、切り捨てる対象とするCHAR、VARCHAR2、NCHAR、NVARCHAR2オペランドまたは列です。Expressionが文字リテラルの場合、一重引用符でその文字を囲みます。 |
TRIM ( Trim_ character FROM Expression ) | ExpressionからTrim_characterの先行文字と後続文字の両方を削除します。 Trim_characterは、Expressionから切り捨てるCHAR、VARCHAR2、NCHAR、NVARCHAR2オペランドまたは列です。1つの文字のみを指定できます。Trim_characterが文字リテラルの場合、一重引用符でその文字を囲みます。 FROMはTrim_characterの後に続ける必要があります。LEADING、TRAILINGまたはBOTH修飾子の指定がないことを前提としています。 Expressionは、切り捨てる対象とするCHAR、VARCHAR2、NCHAR、NVARCHAR2オペランドまたは列です。Expressionが文字リテラルの場合、一重引用符でその文字を囲みます。 |
TRIM ( Expression ) | 修飾子またはTrim_characterなしでExpressionを指定すると、Expressionから先行および後続の空白文字が削除されます。 Expressionは、切り捨てる対象とするCHAR、VARCHAR2、NCHAR、NVARCHAR2オペランドまたは列です。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型の場合:
- TT_CHAR、TT_VARCHAR、TT_NCHARおよびTT_NVARCHAR型の場合:
例3.85
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.
例3.86
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.
例3.87
TRIM関数をTrim_characterの0(ゼロ)とともに使用します。修飾子は指定しません。Expressionの'0000TRIM Example0000'から、先行および後続の0(ゼロ)が削除されます。
Command> SELECT TRIM ('0' FROM '0000TRIM Example0000') FROM Dual;
< TRIM Example >
1 row found.
例3.88
TRIM関数を修飾子またはTrim_characterなしで使用します。先行および後続の空白文字が削除されます。
Command> SELECT TRIM (' TRIM Example ') FROM Dual;
< TRIM Example >
1 row found.