LPAD

LPAD 関数は、文字列を右側から切り捨てるか、左側にスペース (または指定された文字) を埋め込んで、返されるすべての値を指定された長さと同じにします。

構文

LPAD (expression, padded_length [, pad_string]) 

備考

•

式の引数は、リテラル、一重引用符で囲んだ変数、または table.columnName を指定する SQL 式にすることができます。指定するカラムのデータ タイプは、VARCHAR または関連するデータ タイプと互換性がある必要がありますが、INTEGER、TINYINT、または CHAR(1) とは互換性がありません。

•

expression が空の文字列または NULL 文字列の場合、LPAD は NULL を返します。

•

padded_length 引数は、返される値の長さを指定する整数です。

•

padded_length がゼロまたは負の場合、LPAD は空の文字列を返します。

•

pad_string 引数はオプションです。省略した場合は、スペースが左パディング文字として使用されます。それ以外の場合は、次の 4 番目の例に示すように、戻り値が指定された整数文字列の長さに達するまで、左パディングとして pad_string が繰り返し追加されます。

•

pad_string が空の文字列または NULL 文字列の場合、LPAD は NULL を返します。

注：関連する関数「RPAD」も参照してください。

例 (最初の文字を取得)

次の SQL の例では、LPAD を使用して、FirstName カラムの値から最初の文字だけを取得します。

SELECT LPAD (table.FirstName, 1) FirstInitial FROM table

例 (値の切り捨て)

次の SQL の例では、LPAD を使用して FamilyName カラムの値を切り捨て、非常に長いファミリ名の最初の 12 文字のみがエイリアス LastName (12) を持つ結果セット カラムに返されるようにします。

SELECT LPAD (table.FamilyName, 12) LastName (12) FROM table

例 (制限値または値のある左パッド)

次の SQL の例では、LPAD を使用して、SectionTitle の値を最初の 36 文字に制限し、36 文字未満のセクションタイトルの前に、文字数を 36 にするのに十分なピリオドを付けています。

SELECT LPAD (table.SectionTitle, 36, '.') FROM table

例 (制限値または値のパターンを持つ左パッド)

pad_string が複数の文字である場合、正確な文字列の長さに達するまで、指定された文字パターン (またはパターンの先頭) がパディングとして繰り返されます。

SELECT LPAD (table.LastName, 8, '*...') FROM table

この例では、「Shimabukuro」の名前は「Shimabuk」を返し、「Ho」の名前は「*...*.Ho」を返します。