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 valeur0
commence à partir du premier caractère destring_expr
. - Valeur de
0
ou inférieure pour des résultatsnumeric_expr_2
dans une chaîne vide.