Partilhar via

SUBSTRING (consulta NoSQL)

  • Artigo

APLICA-SE A: NoSQL

Retorna parte de uma expressão de cadeia de caracteres começando na posição especificada e do comprimento especificado, ou até o final da cadeia de caracteres.

Sintaxe

SUBSTRING(<string_expr>, <numeric_expr_1>, <numeric_expr_2>)

Argumentos

Description
string_expr Uma expressão de cadeia de caracteres.
numeric_expr_1 Uma expressão numérica para indicar o caractere inicial.
numeric_expr_2 Uma expressão numérica para indicar o número máximo de caracteres a serem retornados string_expr .

Tipos de devolução

Retorna uma expressão de cadeia de caracteres.

Exemplos

O exemplo a seguir retorna substrings com vários comprimentos e posições iniciais.

SELECT VALUE {
    substringPrefix: SUBSTRING("AdventureWorks", 0, 9),
    substringSuffix: SUBSTRING("AdventureWorks", 9, 5),
    substringTotalLength: SUBSTRING("AdventureWorks", 0, LENGTH("AdventureWorks")),
    substringEmptyString: SUBSTRING("AdventureWorks", 0, -1)
}

[
  {
    "substringPrefix": "Adventure",
    "substringSuffix": "Works",
    "substringTotalLength": "AdventureWorks",
    "substringEmptyString": ""
  }
]

Observações

  • Esta função beneficia de um índice de intervalo se a posição inicial for 0.
  • numeric_expr_1 as posições são baseadas em zero, portanto, um valor de 0 começa a partir do primeiro caractere de string_expr.
  • Um valor igual ou inferior para numeric_expr_2 resulta em cadeia de 0 caracteres vazia.

Conteúdos relacionados