Compartilhar 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 com o comprimento especificado, ou até o final da cadeia de caracteres.

Sintaxe

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

Argumentos

Descrição
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 de string_expr a serem retornados.

Tipos de retorno

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

Comentários

  • Essa função se beneficia de um índice de intervalo se a posição inicial for 0.
  • As posições numeric_expr_1 são baseadas em zero, portanto, um valor de 0 começa desde o primeiro caractere de string_expr.
  • Um valor de 0 ou menos para numeric_expr_2 resulta em uma cadeia de caracteres vazia.

Conteúdo relacionado