$indexOfArray
¶3.4版的新功能。
在数组中搜索指定值的出现,并返回第一次出现的数组索引(从零开始)。如果找不到该值,则返回-1
。
领域 | 类型 | 描述 |
---|---|---|
<array> |
串 | 只要它可以解析为数组,就可以是任何有效的表达式。有关表达式的更多信息,请参见 表达式。 如果数组表达式解析为 如果数组表达式不能解析为数组, |
<search value> |
串 | 可以是任何有效的表达式。有关表达式的更多信息,请参见表达式。 |
<start> |
整数 | 可选的。一个整数或可以表示为整数的数字(例如2.0),它指定搜索的起始索引位置。可以是任何可解析为非负整数的有效表达式。 如果未指定,则搜索的起始索引位置是字符串的开头。 |
<end> |
整数 | 可选的。一个整数或可以表示为整数的数字(例如2.0),它指定搜索的结束索引位置。可以是任何可解析为非负整数的有效表达式。如果指定
如果未指定,则搜索的结束索引位置为字符串的结尾。 |
如果在中多次找到
,则从起始索引位置返回第一个索引。<search expression>
<array expression>
$indexOfArray
<search expression>
$indexOfArray
返回null
:
<array expression>
<array expression>
$indexOfArray
返回错误:
<array expression>
<start>
或是<end>
一个负整数(或可以表示为负整数的值,如-5.0)。$indexOfArray
返回-1
:
<start>
一个数字大于<end>
,或<start>
是一个大于数组长度的数字。例 | 结果 |
---|---|
{ $indexOfArray: [ [ "a", "abc" ], "a" ] } |
0 |
{ $indexOfArray: [ [ "a", "abc", "de", ["de"] ], ["de"] ] } |
3 |
{ $indexOfArray: [ [ 1, 2 ], 5 ] } |
-1 |
{ $indexOfArray: [ [ 1, 2, 3 ], [1, 2] ] } |
-1 |
{ $indexOfArray: [ [ 10, 9, 9, 8, 9 ], 9, 3 ] } |
4 |
{ $indexOfArray: [ [ "a", "abc", "b" ], "b", 0, 1 ] } |
-1 |
{ $indexOfArray: [ [ "a", "abc", "b" ], "b", 1, 0 ] } |
-1 |
{ $indexOfArray: [ [ "a", "abc", "b" ], "b", 20 ] } |
-1 |
{ $indexOfArray: [ [ null, null, null ], null ] } |
0 |
{ $indexOfArray: [ null, "foo" ] } |
null |
{ $indexOfArray: [ "foo", "foo" ] } |
错误 |