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

1. 语法

1. SUBSTR(string, pos [, substring_length] )

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() 函数的别名，其用法是：

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

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

4. 示例

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

4. -- 当pos=0时，视为pos=1
5. greatsql> SELECT SUBSTR('GreatSQL', 0, 1);
6. +--------------------------+
7. | SUBSTR('GreatSQL', 0, 1) |
8. +--------------------------+
9. | G                        |
10. +--------------------------+

12. greatsql> SELECT SUBSTR('GreatSQL', 1, 1);
13. +--------------------------+
14. | SUBSTR('GreatSQL', 1, 1) |
15. +--------------------------+
16. | G                        |
17. +--------------------------+

19. -- 当结果为空值时，返回NULL
20. greatsql> SELECT SUBSTR('GreatSQL', 9, 1);
21. +--------------------------+
22. | SUBSTR('GreatSQL', 9, 1) |
23. +--------------------------+
24. | NULL                     |
25. +--------------------------+

27. -- 转义字符视为1个字符处理
28. greatsql> SELECT SUBSTR('\"GreatSQL', 1);
29. +-------------------------+
30. | SUBSTR('\"GreatSQL', 1) |
31. +-------------------------+
32. | "GreatSQL               |
33. +-------------------------+

35. -- 切换到DEFAULT mode下
36. -- 当pos=0时，返回总是空值
37. greatsql> SELECT SUBSTR('GreatSQL', 0, 1);
38. +--------------------------+
39. | SUBSTR('GreatSQL', 0, 1) |
40. +--------------------------+
41. |                          |
42. +--------------------------+

44. -- 当结果为空值时，显式''，而非NULL
45. greatsql> SELECT SUBSTR('GreatSQL', 9, 1);
46. +--------------------------+
47. | SUBSTR('GreatSQL', 9, 1) |
48. +--------------------------+
49. |                          |
50. +--------------------------+

问题反馈

联系我们

扫码关注微信公众号

greatsql-wx