LTRIM関数は、Expression1
の左端から、Expression2
に含まれるすべての文字を削除します。TimesTenでは、Expression1
の最初の文字からスキャンが開始され、Expression2
に存在しない文字になるまでExpression2
に指定した文字がすべて削除された後、結果が戻されます。
SQL構文
LTRIM (Expression1 [,Expression2])
パラメータ
LTRIMには、次のパラメータがあります。
パラメータ | 説明 |
---|---|
Expression1 |
切捨ての対象とするCHAR、VARCHAR2、NCHAR、NVARCHAR2オペランドまたは列。 Expression1 が文字リテラルの場合、一重引用符でその文字を囲みます。 |
Expression2 |
Expression1 の切捨てに使用するオプションの式。Expression2 が文字リテラルの場合、一重引用符でその文字を囲みます。Expression2 を指定しない場合、デフォルトで単一の空白文字に設定されます。オペランドまたは列には、CHAR、VARCHAR2、NCHARまたはNVARCHAR2型を指定できます。 |
説明
Expression1
がCHARまたはVARCHAR2型の場合、戻されるデータ型はVARCHAR2です。Expression1
がNCHARまたはNVARCHAR2型の場合、戻されるデータ型はNVARCHAR2です。戻されるデータ型の長さは、Expression1
のデータ型の長さに等しくなります。
Expression1
が文字長セマンティクスで定義されたデータ型の場合、戻される長さは文字長セマンティクスで表現されます。
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
はLTRIMの実行前にCHARまたはVARCHAR2に変換されます。Expression2
の変換は失われる可能性があります。Expression2
の切捨て文字がデータベースのキャラクタ・セットに含まれない場合、問合せにより予期しない結果が発生する可能性があります。
CHAR、VARCHAR2、NCHARおよびNVARCHAR2型の場合:
Expression1
のすべての文字がLTRIM関数により削除された場合、結果はNULLになります。
TT_CHAR、TT_VARCHAR、TT_NCHARおよびTT_NVARCHAR型の場合:
Expression1
のすべての文字がLTRIM関数により削除された場合、結果は空の文字列になります。
例
LTRIM関数をコールして、左端のxおよびyを文字列から削除します。 LTRIMは、xyというパターンではなく、個々に出現するxとyを削除します。
Command> SELECT LTRIM ('xxxyyyxyxyLTRIM Example', 'xy') FROM dual; < LTRIM Example > 1 row found.
LTRIM関数をコールして、SYSDATEからYYYY-MM-DDを削除します。TO_CHARをコールしてSYSDATEをVARCHAR2に変換します。
Command> SELECT LTRIM (TO_CHAR(SYSDATE), '2007-08-21') FROM dual; < 22:54:39 > 1 row found.
LTRIMをコールして、Expression1
からすべての文字を削除します。最初の例では、データ型がCHARであるため、NULLが戻されます。2番目の例では、データ型がTT_CHARであるため、空の文字列が戻されます。
Command> CREATE TABLE ltrimtest (col1 CHAR (4), col2 TT_CHAR (4)); Command> INSERT INTO ltrimtest VALUES ('ABBB','ABBB'); 1 row inserted. Command> SELECT LTRIM (col1, 'AB') FROM ltrimtest; < <NULL> > 1 row found. Command> SELECT LTRIM (col2, 'AB') FROM ltrimtest; < > 1 row found.