# lpad
返回指定长度的字符串。给定字符串str长度小于指定长度len时，由指定字符pad从左侧填补；给定字符串str长度大于指定长度len时，从左截取len个字符。
#### 命令格式
```
lpad(string <str>, int <len>[, string <pad>])
```
#### 参数说明
| 参数  | 是否必选 | 参数类型   | 说明                  |
|:---|:---|:---|:---|
| str | 是    | STRING | 待补位的字符串。            |
| len | 是    | INT    | 结果字符串的长度。           |
| pad | 否    | STRING | 用于补位的字符串。不指定时默认为空格。 |
   
#### 返回值说明
返回STRING类型的值。
![](https://support.huaweicloud.com/sqlref-spark-aidatalake/public_sys-resources/note_3.0-zh-cn.png)
- 如果len小于str的字符数，则返回str从左开始截取len位的字符串。
- 如果len为0，则返回空串。
- 如果没有输入参数或任一输入参数值为NULL，返回NULL。
 
#### 示例代码
用字符串ZZ将字符串abcdefgh向左补足到10位，返回ZZabcdefgh。
```
select lpad('abcdefgh', 10, 'ZZ');
```
用字符串ZZ将字符串abcdefgh向左补足到5位，返回abcde。
```
select lpad('abcdefgh', 5, 'ZZ');
```
length为0，返回空串。
```
select lpad('abcdefgh', 0, 'ZZ');
```
任一输入参数为NULL，返回NULL。
```
select lpad(null, 0, 'ZZ');
```