§ 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,会传回空字符。
  • stringpossubstring_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