$substrCP（按码点提取子串）

最后更新：2026-10-09

$substrCP（按码点提取子串）

$substrCP 按 Unicode 码点（可理解为字符）提取子串，位置和长度都以码点为单位。它对中文、日文、emoji 等多字节字符完全安全，是提取用户可见文本的推荐操作符。与按 UTF-8 字节计数的 $substrBytes 相比，语义更贴近人类对「字符」的理解。start 为负数返回空字符串，length 为负数返回剩余全部。

📝 语法

{ $substrCP: [ <字符串表达式>, <码点起始位置>, <码点长度> ] }

⚙️ 参数

返回值：提取的子串；任一参数为 null 时返回 null。

▶ 示例

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

// $substrCP：取昵称前 2 个字
 db.users.aggregate([
  { $project: { nickname: { $substrCP: [ '$name', 0, 2 ] } } }
])

运行结果：

{ "_id": 1, "nickname": "阿明" }
{ "_id": 2, "nickname": "小美" }

📌 注意事项

• 按码点计数，一个汉字、一个 emoji 都算 1
• start 为负数返回空字符串，length 为负数返回剩余全部
• 与 $strLenCP 配套使用可避免越界

🏷️ 相关标签

💡 相关案例

📚 相关教程

❓ 常见问题

Web-Tutorial 技术团队

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

关于我们