该 IS_STRING 函数返回一个布尔值,该值指示指定表达式的类型是否为字符串。
一个 Azure Cosmos DB for NoSQL 系统函数,如果指定表达式的类型是字符串,则返回 true。
Syntax
IS_STRING(<expr>)
Arguments
| Description | |
|---|---|
expr |
任何表达式。 |
返回类型
返回布尔表达式。
例子
本部分包含有关如何使用此查询语言构造的示例。
检查值是否为字符串
在此示例中,该 IS_STRING 函数用于检查各种值,以查看它们是否为字符串。
SELECT VALUE {
isBooleanAString: IS_STRING(true),
isNumberAString: IS_STRING(1),
isStringAString: IS_STRING("value"),
isArrayAString: IS_STRING([ "green", "red", "yellow" ]),
isNullAString: IS_STRING(null),
isObjectAString: IS_STRING({ "name": "Tecozow coat" }),
isObjectStringPropertyAString: IS_STRING({ "name": "Tecozow coat" }.name),
isObjectBooleanPropertyAString: IS_STRING({ "onSale": false }.onSale),
isUndefinedAString: IS_STRING({}.category)
}
[
{
"isBooleanAString": false,
"isNumberAString": false,
"isStringAString": true,
"isArrayAString": false,
"isNullAString": false,
"isObjectAString": false,
"isObjectStringPropertyAString": true,
"isObjectBooleanPropertyAString": false,
"isUndefinedAString": false
}
]
注解
- 此函数受益于范围索引的使用。 有关详细信息,请参阅 范围索引。