该 STARTSWITH 函数返回一个布尔值,该值指示第一个字符串表达式是否以第二个字符串表达式开头。
一个 Azure Cosmos DB for NoSQL 系统函数,该函数返回一个布尔值,指示一个字符串表达式是否以另一个字符串表达式开头。
Syntax
STARTSWITH(<string_expr_1>, <string_expr_2> [, <bool_expr>])
Arguments
| Description | |
|---|---|
string_expr_1 |
字符串表达式。 |
string_expr_2 |
要与开头进行比较的 string_expr_1字符串表达式。 |
bool_expr |
用于忽略大小写的可选值。 如果设置为 true, STARTSWITH 则执行不区分大小写的搜索。 未指定时,此默认值为 false. |
返回类型
返回布尔表达式。
例子
本部分包含有关如何使用此查询语言构造的示例。
检查字符串是否以另一个字符串开头
在此示例中,该 STARTSWITH 函数用于检查字符串是否以给定前缀开头,且不区分大小写。
SELECT VALUE {
startsWithWrongPrefix: STARTSWITH("AdventureWorks", "Works"),
startsWithCorrectPrefix: STARTSWITH("AdventureWorks", "Adventure"),
startsWithPrefixWrongCase: STARTSWITH("AdventureWorks", "adventure"),
startsWithPrefixCaseInsensitive: STARTSWITH("AdventureWorks", "adventure", true)
}
[
{
"startsWithWrongPrefix": false,
"startsWithCorrectPrefix": true,
"startsWithPrefixWrongCase": false,
"startsWithPrefixCaseInsensitive": true
}
]
注解
- 此函数执行精确的索引扫描。