$
聚合运算符在字符串中搜索子字符串的出现位置并返回第一次出现的 UTF-8字节索引(从零开始)。如果未找到子字符串,则返回-1
。
语法
{
$indexOfBytes: [ <string expression>, <substring expression>, <start>, <end> ] }
参数说明:
参数 | 说明 |
---|---|
<string expression> |
字符串表达式,如果表达式的值为null 或应用的字段缺失,则返回null ;如果表达式的值不为字符串、null、或字段缺失,则报错 |
<substring expression> |
要搜索的字符串,可以是任何可解析为字符串的表达式 |
<start> |
可选参数,可解析为大于等于零的整数的表达式,用于指定从什么位置开始搜索 |
<end> |
可选参数,可解析为大于等于零的整数的表达式,用于指定搜索的停止位置;如果指定的<end> 则必须同时指定<start> |
使用
- 如果
<string expression
为null
,$indexOfBytes
返回null
- 如果
$indexOfBytes
引用的字段在文档中不存在,则$indexOfBytes
返回null
- 如果
<string expression>
不是字符串且不为null
,则$indexOfBytes
返回错误 - 如果
<substring expression>
为null
,$indexOfBytes
返回错误 - 如果
<start>
或