DocumentDB SQL - 字符串函数



字符串函数对字符串输入值执行操作,并返回字符串、数值或布尔值。以下是支持的内置字符串函数。

序号 函数及描述
1

LENGTH (str_expr)

返回指定字符串表达式的字符数。

2

CONCAT (str_expr, str_expr [, str_expr])

返回连接两个或多个字符串值的结果字符串。

3

SUBSTRING (str_expr, num_expr, num_expr)

返回字符串表达式的一部分。

4

STARTSWITH (str_expr, str_expr)

返回一个布尔值,指示第一个字符串表达式是否以第二个字符串表达式结尾。

5

ENDSWITH (str_expr, str_expr)

返回一个布尔值,指示第一个字符串表达式是否以第二个字符串表达式结尾。

6

CONTAINS (str_expr, str_expr)

返回一个布尔值,指示第一个字符串表达式是否包含第二个字符串表达式。

7

INDEX_OF (str_expr, str_expr)

返回第二个字符串表达式在第一个指定字符串表达式中第一次出现的起始位置,如果未找到字符串,则返回 -1。

8

LEFT (str_expr, num_expr)

返回具有指定字符数的字符串的左侧部分。

9

RIGHT (str_expr, num_expr)

返回具有指定字符数的字符串的右侧部分。

10

LTRIM (str_expr)

删除前导空格后返回字符串表达式。

11

RTRIM (str_expr)

截断所有尾随空格后返回字符串表达式。

12

LOWER (str_expr)

将大写字符数据转换为小写后返回字符串表达式。

13

UPPER (str_expr)

将小写字符数据转换为大写后返回字符串表达式。

14

REPLACE (str_expr, str_expr, str_expr)

将指定字符串值的所有出现替换为另一个字符串值。

15

REPLICATE (str_expr, num_expr)

重复指定次数的字符串值。

16

REVERSE (str_expr)

返回字符串值的逆序。

让我们来看一个使用一些内置字符串函数的示例。

Built-in String

以下是包含不同字符串函数的查询。

SELECT 
   CONCAT("There are ", "2", " items") AS StrConcat, 
   CONTAINS("Abcdef", "cde") AS StrContains, 
   STARTSWITH("Abcdef", "Ab") AS StrStartsWith, 
   ENDSWITH("Abcdef", "cdef") AS StrEndsWith,
	
   INDEX_OF("Abcdef", "de") AS StrIndexOf1, 
   INDEX_OF("Abcdef", "df") AS StrIndexOf2, 
	
   LEFT("Abcdef", 3) AS StrLeft, 
   RIGHT("Abcdef", 3) AS StrRight, 
	
   SUBSTRING("Abcdef", 2, 3) AS StrSubstring, 
   LENGTH("Abcdef") AS StrLength, 
   LOWER("Abcdef") AS StrLower, 
   UPPER("Abcdef") AS StrUpper

执行上述查询后,将产生以下输出。

[ 
   { 
      "StrConcat": "There are 2 items", 
      "StrContains": true, 
      "StrStartsWith": true, 
      "StrEndsWith": true, 
      "StrIndexOf1": 3, 
      "StrIndexOf2": -1, 
      "StrLeft": "Abc", 
      "StrRight": "def", 
      "StrSubstring": "cde", 
      "StrLength": 6, 
      "StrLower": "abcdef", 
      "StrUpper": "ABCDEF" 
   } 
]
documentdb_sql_builtin_function.htm
广告