DocumentDB SQL - Função String

As funções de string executam uma operação em um valor de entrada de string e retornam um valor string, numérico ou booleano. A seguir estão as funções de string integradas com suporte.

S.No. Descrição da função
1

LENGTH (str_expr)

Retorna o número de caracteres da expressão de string especificada.

2

CONCAT (str_expr, str_expr [, str_expr])

Retorna uma string que é o resultado da concatenação de dois ou mais valores de string.

3

SUBSTRING (str_expr, num_expr, num_expr)

Retorna parte de uma expressão de string.

4

STARTSWITH (str_expr, str_expr)

Retorna um booleano indicando se a primeira expressão de string termina com a segunda.

5

ENDSWITH (str_expr, str_expr)

Retorna um booleano indicando se a primeira expressão de string termina com a segunda.

6

CONTAINS (str_expr, str_expr)

Retorna um booleano indicando se a primeira expressão de string contém a segunda.

7

INDEX_OF (str_expr, str_expr)

Retorna a posição inicial da primeira ocorrência da segunda expressão de string dentro da primeira expressão de string especificada, ou -1 se a string não for encontrada.

8

LEFT (str_expr, num_expr)

Retorna a parte esquerda de uma string com o número especificado de caracteres.

9

RIGHT (str_expr, num_expr)

Retorna a parte direita de uma string com o número especificado de caracteres.

10

LTRIM (str_expr)

Retorna uma expressão de string após remover os espaços em branco à esquerda.

11

RTRIM (str_expr)

Retorna uma expressão de string depois de truncar todos os espaços em branco à direita.

12

LOWER (str_expr)

Retorna uma expressão de string após converter dados de caracteres maiúsculos em minúsculos.

13

UPPER (str_expr)

Retorna uma expressão de string após converter dados de caracteres minúsculos em maiúsculas.

14

REPLACE (str_expr, str_expr, str_expr)

Substitui todas as ocorrências de um valor de string especificado por outro valor de string.

15

REPLICATE (str_expr, num_expr)

Repete um valor de string um número especificado de vezes.

16

REVERSE (str_expr)

Retorna a ordem reversa de um valor de string.

Vamos dar uma olhada em um exemplo onde algumas funções de string integradas são usadas.

A seguir está a consulta com diferentes funções de 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

Quando a consulta acima é executada, ela produz a seguinte saída.

[ 
   { 
      "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" 
   } 
]