$indexOfArray
聚合运算符返回指定值在数组中第一次出现的索引位置,数组的索引从0开始。
语法
{
$indexOfArray: [ <array expression>, <search expression>, <start>, <end> ] }
$indexOfArray
参数说明:
<array>
,字符串,可以是任何能够解析为数组的表达式,如果表达式解析为null
或引用的字段不存在,$indexOfArray
返回null
。如果表达式不能解析为数组或null且引用的字段都存在,$indexOfArray
将返回错误。<search value>
,字符串,可以是任意合法的表达式。<start>
,可选,整数或可以转换为整数的数值(如:2.0),必须大于等于0,用于指定从数组的哪个元素开始检索。<end>
,可选,整数或可以转换为整数的数值(如:2.0),必须大于等于0,用于指定结束检索的元素位置。如果指定了<end>
就应该同时指定<start>
,不然$indexOfArray
会将<end>
当作<start>
。如果不指定,则为字符串的最后位置。
使用
- 如果
<search expression
在<array expression>
中能检索到多次,$indexOfArray
返回第一个检索到的位置索引。 - 如果
<array expression>
为null
或引用的字段不存在,indexOfArray
返回null
。 - 如果
<array expression>
不是数组且不为空,或者<start>
或<end>
是负值,$indexOfArray
返回错误。 - 如果
<search expression>
在数组中未检索到或<start>
大于<end>
或<start>
大于数组长度,则$indexOfArray
返回-1
。
用下面的例子进一步说明:
例如 | 结果 |
---|---|
{ $indexOfArray: [ [ "a", "abc" ], "a" ] } |
0 |
{ $indexOfArray: [ [ "a", "abc", "de", ["de"] ], ["de"] ] } |
3 |
{ $indexOfArray: [ [ 1, 2 ], 5 ] } |