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