$indexOfCP（按码点查找子串位置）

最后更新：2026-10-09

$indexOfCP（按码点查找子串位置）

$indexOfCP 返回子串在字符串中首次出现的码点（字符）位置，找不到返回 -1。它以「字符」为单位，与人类阅读的位置一致，对中文、emoji 安全，是文本处理场景的首选。可传 start、end 限定范围，范围同样按码点计算。常与 $substrCP、$strLenCP 组合做文本截取。任一参数为 null 时返回 null。

📝 语法

{ $indexOfCP: [ <字符串表达式>, <子串>, <起始位置>, <结束位置> ] }

⚙️ 参数

返回值：码点位置（从 0 起）；找不到返回 -1；任一参数为 null 时返回 null。

▶ 示例

请在本地安装的 mongosh 中执行以下命令（需已启动 mongod）：

// $indexOfCP：定位邮箱中的 @ 符号
 db.users.aggregate([
  { $project: { at: { $indexOfCP: [ '$email', '@' ] } } }
])

运行结果：

{ "_id": 1, "at": 6 }
{ "_id": 2, "at": -1 }

📌 注意事项

• 从 0 开始，中文、emoji 各算 1
• 常与 $substrCP、$strLenCP 组合做文本截取
• start/end 超出字符串长度时按边界处理，不会报错

🏷️ 相关标签

💡 相关案例

📚 相关教程

❓ 常见问题

Web-Tutorial 技术团队

由多位开发者共同维护的编程教程平台。每篇教程由对应领域的开发者编写和审核，确保内容准确可靠。如发现任何问题，欢迎向我们反馈。

关于我们