SelectDB Enterprise
参考手册
SQL 函数
标量函数
字符串函数
RPAD

RPAD

描述

用于在原始字符串的右侧填充指定的字符,直到达到指定的长度。

语法

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

参数

参数说明
<str>需要被填充的字符串
<len>最终结果字符串的总长度,指的是字符长度而不是字节长度
<pad>用于填充的字符串

:::tip <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, '') |
+-----------------------+
|                       |
+-----------------------+
© 2025 北京飞轮数据科技有限公司 京ICP备2022004029号 | Apache、Apache Doris 以及相关开源项目名称均为 Apache 基金会商标