RPAD

RPAD関数は、n文字の長さになるまでExpression2を必要な数だけ繰り返して右側を埋め込んだExpression1を戻します。この関数は、問合せの出力を書式設定する場合に役立ちます。

SQL構文

RPAD (Expression1, n [,Expression2])

パラメータ

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

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

説明

• Expression1がCHAR型またはVARCHAR2型の場合、戻されるデータ型はVARCHAR2です。Expression1がNCHAR型またはNVARCHAR2型の場合、戻されるデータ型はNVARCHAR2です。Expression1がLOBの場合、戻されるデータ型は指定されたLOBデータ型と同じになります。

• 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、CLOBまたはNCLOBデータ型の場合:

  • Expression1とExpression2のどちらかがNULLの場合、結果はNULLになります。nが0 (ゼロ)以下の場合も、結果はNULLです。

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

  • Expression1とExpression2のどちらかがNULLではなく、nが0以下の場合、結果は空の文字列になります。

例

employees表のfirst_nameとlast_nameを連結します。RPAD関数をコールして、右側が空白文字で埋め込まれた長さ12のfirst_nameを戻し、もう一度RPADをコールして右側が空白文字で埋め込まれた長さ12のlast_nameを戻します。先頭の5行を選択します。

Command> SELECT FIRST 5 CONCAT (RPAD (first_name,12),
           RPAD (last_name,12)) FROM employees
              ORDER BY first_name, last_name;
< Adam        Fripp        >
< Alana       Walsh        >
< Alberto     Errazuriz    >
< Alexander   Hunold       >
< Alexander   Khoo         >
5 rows found.

RPAD関数をコールして、右側がドット文字('.')で埋め込まれた長さ20のlast_nameを戻します。employees表を使用して、先頭の5行を選択します。

Command> SELECT FIRST 5 RPAD (last_name,20,'.') FROM employees
           ORDER BY last_name;
< Abel................ >
< Ande................ >
< Atkinson............ >
< Austin.............. >
< Baer................ >
5 rows found.