SUBSTRING (consulta NoSQL)

  • Artigo

APLICA-SE A: NoSQL

Devolve parte de uma expressão de cadeia a partir da posição especificada e do comprimento especificado ou ao fim da cadeia.

Sintaxe

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

Argumentos

Description
string_expr Uma expressão de cadeia.
numeric_expr_1 Uma expressão numérica para denotar o caráter inicial.
numeric_expr_2 Uma expressão numérica para denotar o número máximo de carateres de string_expr a devolver.

Tipos de devolução

Devolve uma expressão de cadeia.

Exemplos

O exemplo seguinte devolve subcadeias 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, pelo que um valor de 0 começa a partir do primeiro caráter de string_expr.
  • Um valor de 0 ou menos para numeric_expr_2 resultados numa cadeia vazia.

Conteúdo relacionado