GreatSQL用户手册

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

§ 1. 语法

SUBSTR(string, pos [, substring_length] )
1

§ 2. 定义和用法

函数 SUBSTR() 的作用是返回字符型参数 string 的一部分。该部分是由 string 的第 pos 个字符开始，取 substring_length 个字符。

  • 若pos为0，视为1，表示string从第1个字符开始。
  • 若pos为正数，表示由string的第pos个字符开始。
  • 若pos为负数，表示由string倒数第pos个字符开始。
  • 若pos为''（空）时，在Oracle模式下，当做1看待。
  • 若substring_length未指定，表示取到string的最后一个字符为止。
  • 若substring_length小于等于0，会传回空字符。
  • 若string、pos、substring_length任意一个值为NULL，则返回NULL。
  • 当string中包含转义字符（例如：\0、'、''、"、\、\b、\B、\n、\N、\r、\R、\t、\T、\z、\Z`）时，不会视为2个字符，而视为1个字符来处理。

§ 3. Oracle兼容说明

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

在Oracle兼容模式下，与GreatSQL原生的 SUBSTR() 函数区别在于两处：

  • 当参数 pos 为0时，Oracle兼容模式下视为1；而GreatSQL原生函数仍视为0，且返回结果总是为空值('')。
  • 当返回结果为空值('')时，Oracle兼容模式下返回NULL；而GreatSQL原生函数仍旧返回空值('')。

GreatSQL原生的 SUBSTR() 函数是 SUBSTRING() 函数的别名，其用法是：

SUBSTRING(str,pos)
SUBSTRING(str FROM pos)
SUBSTRING(str,pos,len)
SUBSTRING(str FROM pos FOR len)
1
2
3
4

更多关于原生的 SUBSTR() 函数用法这里不再赘述。

§ 4. 示例

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

-- 当pos=0时，视为pos=1
greatsql> SELECT SUBSTR('GreatSQL', 0, 1);
+--------------------------+
| SUBSTR('GreatSQL', 0, 1) |
+--------------------------+
| G                        |
+--------------------------+

greatsql> SELECT SUBSTR('GreatSQL', 1, 1);
+--------------------------+
| SUBSTR('GreatSQL', 1, 1) |
+--------------------------+
| G                        |
+--------------------------+

-- 当结果为空值时，返回NULL
greatsql> SELECT SUBSTR('GreatSQL', 9, 1);
+--------------------------+
| SUBSTR('GreatSQL', 9, 1) |
+--------------------------+
| NULL                     |
+--------------------------+

-- 转义字符视为1个字符处理
greatsql> SELECT SUBSTR('\"GreatSQL', 1);
+-------------------------+
| SUBSTR('\"GreatSQL', 1) |
+-------------------------+
| "GreatSQL               |
+-------------------------+

-- 切换到DEFAULT mode下
-- 当pos=0时，返回总是空值
greatsql> SELECT SUBSTR('GreatSQL', 0, 1);
+--------------------------+
| SUBSTR('GreatSQL', 0, 1) |
+--------------------------+
|                          |
+--------------------------+

-- 当结果为空值时，显式''，而非NULL
greatsql> SELECT SUBSTR('GreatSQL', 9, 1);
+--------------------------+
| SUBSTR('GreatSQL', 9, 1) |
+--------------------------+
|                          |
+--------------------------+
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

greatsql-wx