Partager via


SUBSTRING (requête NoSQL)

S’APPLIQUE À : NoSQL

Renvoie une partie d’une expression de chaîne commençant à la position de longueur spécifiée ou à la fin de la chaîne.

Syntaxe

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

Arguments

Description
string_expr Expression de chaîne.
numeric_expr_1 Expression numérique indiquant le caractère de début.
numeric_expr_2 Expression numérique indiquant le nombre maximal de caractères de string_expr à retourner.

Types de retour

Retourne une expression de chaîne.

Exemples

L’exemple suivant retourne des sous-chaînes avec diverses longueurs et positions de départ.

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

Remarques

  • Cette fonction système bénéficie d’un index de plage si la position de départ est 0.
  • Les positions numeric_expr_1 sont basées sur zéro. Par conséquent, la valeur 0 commence à partir du premier caractère de string_expr.
  • Valeur de 0 ou inférieure pour des résultats numeric_expr_2 dans une chaîne vide.