$bitsAnyClear（任一位未设置）
最后更新：2026-10-09
$bitsAnyClear（任一位未设置）
$bitsAnyClear 匹配数值字段中给定位置至少有一位为 0 的文档。`{ flags: { $bitsAnyClear: 7 } }`（7 的二进制为 111）匹配第 0、1、2 位中至少一位为 0 的文档。与 $bitsAllClear 相比条件更宽松。仅支持整数与 BinData 字段。
| 分类 | 位运算 |
|---|---|
| MongoDB 版本 | 3.2+ |
| 示例语言 | mongosh (Shell) |
📝 语法
{ <字段>: { $bitsAnyClear: <位掩码或位置数组> } }⚙️ 参数
| 字段 | 要匹配的整数或 BinData 字段名。 |
|---|---|
| 位掩码 | 整数位掩码或位置数组，如 7 或 [0, 1, 2]。 |
返回值：匹配的文档游标
▶ 示例
请在本地安装的 mongosh 中执行以下命令（需已启动 mongod）：
// $bitsAnyClear：第 0、1、2 位中至少一位为 0
// 7 的二进制是 111
db.users.find({ flags: { $bitsAnyClear: 7 } })
// 位置数组写法
db.users.find({ flags: { $bitsAnyClear: [0, 1, 2] } })运行结果：
// 返回 flags 第 0、1、2 位中至少一位为 0 的用户📌 注意事项
- 与 $bitsAllClear 区别：一位为 0 即匹配，不需要全部为 0
- 适合「存在未开启项」的检查
- 只支持 int、long、BinData
🏷️ 相关标签
💡 相关案例
更多实战案例即将上线，敬请期待。
📚 相关教程
❓ 常见问题
Q$bitsAnyClear 和 $bitsAllClear 的区别？
A$bitsAnyClear 只要有一位为 0 即匹配；$bitsAllClear 要求所有指定位都为 0。
Q怎么查某位未设置？
A{ $bitsAnyClear: [2] } 即第 2 位为 0。
Q支持浮点吗？
A不支持，仅 int、long、BinData。
