SUBTEKENREEKS (NoSQL-query)
VAN TOEPASSING OP: NoSQL
Retourneert een deel van een tekenreeksexpressie die begint op de opgegeven positie en van de opgegeven lengte, of aan het einde van de tekenreeks.
Syntaxis
SUBSTRING(<string_expr>, <numeric_expr_1>, <numeric_expr_2>)
Argumenten
Beschrijving | |
---|---|
string_expr |
Een tekenreeksexpressie. |
numeric_expr_1 |
Een numerieke expressie om het beginteken aan te geven. |
numeric_expr_2 |
Een numerieke expressie om het maximum aantal tekens aan te geven dat string_expr moet worden geretourneerd. |
Retourtypen
Retourneert een tekenreeksexpressie.
Voorbeelden
In het volgende voorbeeld worden subtekenreeksen met verschillende lengten en beginposities geretourneerd.
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": ""
}
]
Opmerkingen
- Deze functie profiteert van een bereikindex als de beginpositie is
0
. numeric_expr_1
posities zijn op nul gebaseerd, dus een waarde van0
begint vanaf het eerste teken vanstring_expr
.- Een waarde van
0
of minder voornumeric_expr_2
resultaten in een lege tekenreeks.