GreatSQL用户手册

§ Oracle兼容-函数-LPAD()函数

§ 1. 语法

LPAD(str,len)
LPAD(str,len,padstr)
1
2

§ 2. 定义和用法

因为GreatSQL已原生支持 LPAD() 函数，因此想要在GreatSQL中使用扩展后的 LPAD() 函数时，需要先执行 SET sql_mode = ORACLE; 激活Oracle兼容模式。

在GreatSQL中，原生的 LPAD() 函数作用是对字符串 str 在其左边补齐字符串 padstr，使其满足总长度为 len 个字符（注意，是字符长度，不是字节长度）。当 str 的长度已经超过 len 值时，则会被截取一部分长度。例如：

greatsql> SET sql_mode = DEFAULT;

greatsql> SELECT LPAD("a", 3, "b");
+-------------------+
| LPAD("a", 3, "b") |
+-------------------+
| bba               |
+-------------------+

greatsql> SELECT LPAD("aaaa", 3, "b");
+----------------------+
| LPAD("aaaa", 3, "b") |
+----------------------+
| aaa                  |
+----------------------+

greatsql> SELECT LPAD("数据库", 8, "GreatSQL");
+----------------------------------+
| LPAD("数据库", 8, "GreatSQL")    |
+----------------------------------+
| Great数据库                      |
+----------------------------------+
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

而在Oracle模式中，函数 LPAD() 最少可以只有2个参数，则其行为是在字符串 str 的左边加上空格补齐，使得字符串最后的总长度为 len 值指定的长度。当参数为3个时，在字符串 str 的左边加上指定字符串 padstr，使最后长度为 len 值指定的长度。

参数 len 值所指的是屏幕的显示长度，而不是字符串的总字符数或者字节数，其中中文字符视为2个字符长度，英文和半角符号视为1个字符长度。

如果要补充的只有一个字符长度，而需要补充的目标字符串为中文，则只会在左边补一个空格。

如果 len 值小于字符串 str 的长度，那么就删除字符串 str 右边的字符。当 str 字符串的长度剩余1个字符并且当前字符为中文的时候，左边补一个空格。如果 len 值为0，那么最后显示NULL。

§ 3. Oracle兼容说明

当GreatSQL的字符集为utf8（utf8mb4/utf8mb3）时，多字节字符显示固定长度为2位，单字节固定显示为1位。此行为大部分结果和Oracle相同，只有少部分多字节字符或半角字符行为和Oracle不一致。

§ 4. 示例

-- 先测试原生的LPAD()函数
greatsql> SET sql_mode = DEFAULT;

greatsql> SELECT LPAD('a', 3, 'b');
+-------------------+
| LPAD("a", 3, "b") |
+-------------------+
| bba               |
+-------------------+

greatsql> SELECT LPAD('aaaa', 3, 'b');
+----------------------+
| LPAD("aaaa", 3, "b") |
+----------------------+
| aaa                  |
+----------------------+

-- 在DEFAULT模式下，每个中文字符长度视为1
greatsql> SELECT LPAD('数据库', 8, 'GreatSQL');
+----------------------------------+
| LPAD("数据库", 8, "GreatSQL")    |
+----------------------------------+
| Great数据库                      |
+----------------------------------+

-- 在DEFAULT模式下，LENGTH()函数计算每个中文长度为3字节
greatsql> SELECT LPAD('据b', 6, '数a'), length(LPAD('据b', 6, '数a'));
+-------------------------+---------------------------------+
| LPAD('据b', 6, '数a')   | length(LPAD('据b', 6, '数a'))   |
+-------------------------+---------------------------------+
| 数a数a据b               |                              12 |
+-------------------------+---------------------------------+

-- 参数至少要求3个
greatsql> SELECT LPAD("数据库", 8);
ERROR 1582 (42000): Incorrect parameter count in the call to native function 'lpad'

-- 切换到Oracle模式
greatsql> SET sql_mode = ORACLE;

-- 每个中文字符长度视为2
-- 在Oracle模式下，LENGTH()函数计算每个中文长度为1个字符
greatsql> SELECT LPAD('据b', 6, '数a'), length(LPAD('据b', 6, '数a'));
+-------------------------+---------------------------------+
| LPAD('据b', 6, '数a')   | length(LPAD('据b', 6, '数a'))   |
+-------------------------+---------------------------------+
| 数a据b                  |                               4 |
+-------------------------+---------------------------------+

-- 要左侧补齐的字符串长度只有1，且为中文，最后只补齐一个空格
greatsql> SELECT LPAD('据b', 6, '数据'), length(LPAD('据b', 6, '数据'));
+---------------------------+-----------------------------------+
| LPAD('据b', 6, '数据')    | length(LPAD('据b', 6, '数据'))    |
+---------------------------+-----------------------------------+
|  数据b                    |                                 4 |
+---------------------------+-----------------------------------+

-- 要左侧补齐的字符串长度只有1，且为中文，最后只补齐一个空格
greatsql> SELECT LPAD('数据库', 1), length(LPAD('数据库', 1));
+----------------------+------------------------------+
| LPAD('数据库', 1)    | length(LPAD('数据库', 1))    |
+----------------------+------------------------------+
|                      |                            1 |
+----------------------+------------------------------+

-- len = 0，返回NULL
greatsql> SELECT LPAD('数据库', 0);
+----------------------+
| LPAD('数据库', 0)    |
+----------------------+
| NULL                 |
+----------------------+
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72

greatsql-wx