RPAD
説明
元の文字列の右側に指定された文字を埋め込んで、指定された長さになるまでパディングするために使用されます。
構文
RPAD ( <str> , <len> , <pad>)
パラメータ
| パラメータ | 説明 |
|---|---|
<str> | パディングされる文字列。 |
<len> | 最終結果文字列の総長さ。バイト長ではなく文字長を表す。 |
<pad> | パディングに使用される文字列。 |
ヒント
<len>パラメータの最大値は10000です。この制限を超えるとエラーが発生します。セッション変数を設定することで制限を調整できます：
set repeat_max_num = 20000
戻り値
パディングされた文字列を返します。特別なケース:
- いずれかのパラメータがNULLの場合、NULLが返されます。
<pad>が空で<len>が<str>の長さより大きい場合、戻り値は空文字列になります。<len>が<str>の長さより小さい場合、<str>を<len>まで切り詰めて得られた文字列が返されます。<len>が0未満の場合、戻り値はNULLになります。
例
SELECT rpad('hello', 1, '');
+----------------------+
| rpad('hello', 1, '') |
+----------------------+
| h |
+----------------------+
SELECT rpad('hello', 10, 'world');
+----------------------------+
| rpad('hello', 10, 'world') |
+----------------------------+
| helloworld |
+----------------------------+
SELECT rpad('hello', 10, '');
+-----------------------+
| rpad('hello', 10, '') |
+-----------------------+
| |
+-----------------------+
