该 IS_ARRAY 函数返回一个布尔值,该值指示指定表达式的类型是否为数组。
一个 Azure Cosmos DB for NoSQL 系统函数,该函数返回一个布尔值,指示表达式是否为数组。
Syntax
IS_ARRAY(<expr>)
Arguments
| Description | |
|---|---|
expr |
任何表达式。 |
返回类型
返回布尔表达式。
例子
本部分包含有关如何使用此查询语言构造的示例。
检查值是否为数组
在此示例中,该 IS_ARRAY 函数用于检查各种类型的对象。
SELECT VALUE {
booleanIsArray: IS_ARRAY(true),
numberIsArray: IS_ARRAY(65),
stringIsArray: IS_ARRAY("AdventureWorks"),
nullIsArray: IS_ARRAY(null),
objectIsArray: IS_ARRAY({size: "small"}),
arrayIsArray: IS_ARRAY([25344, 82947]),
arrayObjectPropertyIsArray: IS_ARRAY({skus: [25344, 82947], vendors: null}.skus),
invalidObjectPropertyIsArray: IS_ARRAY({skus: [25344, 82947], vendors: null}.size),
nullObjectPropertyIsArray: IS_ARRAY({skus: [25344, 82947], vendors: null}.vendor)
}
[
{
"booleanIsArray": false,
"numberIsArray": false,
"stringIsArray": false,
"nullIsArray": false,
"objectIsArray": false,
"arrayIsArray": true,
"arrayObjectPropertyIsArray": true,
"invalidObjectPropertyIsArray": false,
"nullObjectPropertyIsArray": false
}
]
注解
- 此函数受益于范围索引的使用。 有关详细信息,请参阅 范围索引。