# rpad
将字符串 str1 向右补足到 length 位，使用字符串 str2 进行补位。
#### 命令格式
```
rpad(string <str1>, int <length>, string <str2>)
```
#### 参数说明
| 参数     | 是否必选 | 参数类型   | 说明          |
|:---|:---|:---|:---|
| str1   | 是    | STRING | 待向右补位的字符串。  |
| length | 是    | INT    | 向右补位后的目标长度。 |
| str2   | 是    | STRING | 用于补位的字符串。   |
   
#### 返回值说明
返回 STRING 类型。
![](https://support.huaweicloud.com/sqlref-spark-aidatalake/public_sys-resources/note_3.0-zh-cn.png)
- 如果 length 小于 str1 的长度，则返回 str1 从左开始截取 length 位的字符串。
- 如果 length 为 0，则返回空串。
- 如果任一输入参数值为 NULL，返回 NULL。
 
#### 示例代码
返回 hi???。
```
SELECT rpad('hi', 5, '??');
```
返回 h。
```
SELECT rpad('hi', 1, '??');
```