RPAD (SQL)
構文
RPAD(string-expression,length[,padstring])
説明
RPAD は、文字列式の最後にパディング文字を追加します。length 文字数にパディングされた文字列のコピーを返します。文字列式が length 文字より長い場合、返される文字列は length 文字まで切り捨てられます。
string-expression が NULL の場合、RPAD は NULL を返します。string-expression が空文字列 ('') の場合、RPAD はすべてパディング文字で構成される文字列を返します。返される文字列は VARCHAR 型です。
RPAD をリンク・テーブルに対するクエリで使用できます。
RPAD は、先頭または末尾の空白を削除しません。先頭または末尾の空白も含めて文字列をパディングします。文字列をパディングする前に先頭または末尾の空白を削除するには、LTRIM、RTRIM、または TRIM を使用します。
引数
string-expression
列の名前、文字列リテラル、ホスト変数、他のスカラ関数の結果などを表すことができる文字列式。VARCHAR データ型に変換できる任意のデータ型を指定できます。string-expression をストリームにはできません。
length
返される文字列の文字数を指定する整数。
padstring
入力の string-expression のパディングに使用される、文字列または 1 文字で構成される文字列 (オプション)。padstring 文字 (列) は、出力文字列が length 文字になるまで必要なだけ string-expression の右側に追加されます。padstring には、文字列リテラル、列、ホスト変数、他のスカラ関数の結果などを指定できます。省略すると、既定で空白スペース文字になります。
例
次の例では、列値を (必要に応じて) ^ 文字で右パディングして、長さが 16 の文字列を返します。ある Name 文字列は右パディングされ、ある Name 文字列は右側が切り捨てられて、長さ 16 の文字列が返されます。
SELECT TOP 15 Name,RPAD(Name,16,'^') AS Name16
FROM Sample.Person
次の例では、列値を (必要に応じて) ^=^ 文字列で右パディングして、長さが 20 の文字列を返します。名前文字列のパディングは必要なだけ繰り返されます。返される文字列には、パディングされた文字列の一部が含まれる場合があります。
SELECT TOP 15 Name,RPAD(Name,20,'^=^') AS Name20
FROM Sample.Person