メインコンテンツまでスキップ
バージョン: 2.1

RPAD

説明

元の文字列の右側に指定された文字を埋め込んで、指定された長さに達するまで行います。

構文

RPAD ( <str> , <len> , <pad>)

パラメータ

Parameterデスクリプション
<str>パディングされる文字列。
<len>最終結果文字列の総長で、バイト長ではなく文字長を表します。
<pad>パディングに使用される文字列。
ヒント

<len>パラメータの最大値は10000です。この制限を超えると、エラーが発生します。セッション変数を設定することで制限を調整できます:

set repeat_max_num = 20000

戻り値

パディングされた文字列を返します。特別なケース:

  • いずれかのParameterがNULLの場合、NULLが返されます。
  • <pad>が空で<len><str>の長さより大きい場合、戻り値は空文字列になります。
  • <len><str>の長さより小さい場合、<str><len>まで切り詰めて得られた文字列が返されます。
  • <len>が0未満の場合、戻り値はNULLになります。

Examples

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, '') |
+-----------------------+
| |
+-----------------------+