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