Oracle TimesTen In-Memory Database SQLリファレンス・ガイド

LPAD

LPAD関数は、左側がExpression2の連続文字で埋め込まれたn文字の長さのExpression1を戻します。この関数は、問合せの出力を書式設定する場合に役立ちます。

SQL構文

LPAD (Expression1, n [,Expression2])

パラメータ

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


パラメータ	説明
Expression1	左側を文字で埋め込むCHAR、VARCHAR2、NCHAR、NVARCHAR2オペランドまたは列。Expression1がnより長い場合、LPADでは、nに一致するExpression1の一部分が戻されます。
n	LPAD関数で戻される文字の長さ。NUMBER型の整数、またはNUMBER型の整数に暗黙的に変換可能な値である必要があります。
Expression2	Expression1の左側を埋め込む連続文字。Expression2を指定しない場合、デフォルトで単一の空白文字に設定されます。オペランドまたは列には、CHAR、VARCHAR2、NCHARまたはNVARCHAR2型を指定できます。

説明

Expression1がCHARまたはVARCHAR2型の場合、戻されるデータ型はVARCHAR2です。Expression1がNCHARまたはNVARCHAR2型の場合、戻されるデータ型はNVARCHAR2です。

nが定数の場合、戻されるデータ型の長さはnに等しくなります。それ以外の場合、結果の最大長である8300が戻されます。

Expression1とExpression2には、TT_CHAR、TT_VARCHAR、TT_NCHARおよびTT_NVARCHARを指定できます。Expression1がTT_CHARまたはTT_VARCHAR型の場合、戻されるデータ型はTT_VARCHARです。Expression1がTT_NCHARまたはTT_NVARCHAR型の場合、戻されるデータ型はTT_NVARCHARです。

CHAR、VARCHAR2、NCHARおよびNVARCHAR2型の場合:

Expression1またはExpression2のいずれかがNULLの場合、結果はNULLです。nが0（ゼロ）以下の場合も、結果はNULLです。

TT_CHAR、TT_VARCHAR、TT_NCHARおよびTT_NVARCHAR型の場合:

Expression1またはExpression2のいずれかがNULLではなく、nが0（ゼロ）以下の場合、結果は空の文字列です。

例3.40

LPAD関数を使用して、文字列'LPAD Function'の左側を文字列'DEMO-ONLY'と2個の空白で埋め込みます。文字列DEMO-ONLYと2個の空白が3回繰り返されます。

Command> SELECT LPAD ('LPAD Function', 46, 'DEMO-ONLY ') FROM Dual;

< DEMO-ONLY DEMO-ONLY DEMO-ONLY LPAD Function >

1 row found.

例3.41

長さ-1を使用してLPAD関数をコールします。NULLが戻されます。

Command> SELECT LPAD ('abc', -1, 'a') FROM Dual;

< <NULL> >

1 row found.