该 STRINGSPLIT 函数返回从指定分隔符分隔源字符串获得的子字符串数组。
该 STRINGSPLIT 函数返回一个由 Azure Cosmos DB for NoSQL 中的指定分隔符分隔源字符串获得的子字符串数组。
Syntax
STRINGSPLIT(<string_expr1>, <string_expr2>)
Arguments
| Description | |
|---|---|
string_expr1 |
要分析的源字符串表达式。 |
string_expr2 |
用作分隔符的字符串。 |
返回类型
返回数组表达式。
例子
本部分包含有关如何使用此查询语言构造的示例。
将字符串拆分为子字符串
在此示例中,该 STRINGSPLIT 函数用于使用各种分隔符将字符串拆分为子字符串。
SELECT VALUE {
seperateOnLetter: STRINGSPLIT("Handlebar", "e"),
seperateOnSymbol: STRINGSPLIT("CARBON_STEEL_BIKE_WHEEL", "_"),
seperateOnWhitespace: STRINGSPLIT("Road Bike", " "),
seperateOnPhrase: STRINGSPLIT("xenmoun mountain bike", "moun"),
undefinedSeperator: STRINGSPLIT("AluminumBikeFrame", undefined),
emptySeparatorString: STRINGSPLIT("Helmet", ""),
emptySourceString: STRINGSPLIT("", "")
}
[
{
"seperateOnLetter": [
"Handl",
"bar"
],
"seperateOnSymbol": [
"CARBON",
"STEEL",
"BIKE",
"WHEEL"
],
"seperateOnWhitespace": [
"Road",
"Bike"
],
"seperateOnPhrase": [
"xen",
" ",
"tain bike"
],
"emptySeparatorString": [
"Helmet"
],
"emptySourceString": [
""
]
}
]
注解
- 此函数不使用索引。