$bitsAllClear$bitsAllClear匹配在 中查询给出的所有位位置均为清除（即0field）的文档。{ <field>: { $bitsAllClear: <numeric bitmask> } }{ <field>: { $bitsAllClear: <BinDatabitmask> } }{ <field>: { $bitsAllClear: [ <position1>, <position2>, ... ] } }field值必须是数字或BinData实例。否则，$bitsAllClear将不匹配当前文档。- 数字位掩码
- 您可以提供与操作数字字段相匹配的数字位掩码。位掩码必须是非负64 位带符号整数。否则，
$bitsAllClear将返回错误。 - BinData Bitmask
- 您也可以使用任意大的
BinData实例作为位掩码。 - 位置列表
- 如果查询位位置列表，每个
<position>必须是非负整数。位位置从最低有效位0开始。例如，十进制数254的位数位置如下：
位值11111110Position
7
6
5
4
3
2
1
0
行为
系统的字节序取决于机器的架构。 BSON数据中的数字始终存储为小端，如果您的系统是大端，这意味着数字数据会在大端和小端之间转换。
在位测试匹配表达式操作符的上下文中：
BinData值充当位掩码，并被解释为任意长度的无符号小端数字。最低可寻址字节始终被解释为最低有效字节。同样，BinData 中的最高可寻址字节始终被解释为最高有效字节。
索引
查询不能对查询的$bitsAllClear 部分使用索引，但查询的其他部分可以使用索引（如果适用）。
浮点值
$bitsAllClear 不会匹配无法表示为带符号的 64 位整数的数值。如果某个值太大或太小，超出带符号 64 位整数的范围，或者该值包含小数部分，则可能会出现这种情况。
符号扩展
数字进行符号扩展。示例，$bitsAllClear 200认为对于负数-5 ，位位置 设立 ，而对于正数200 ，位位置+5 则视为清除。
相反，BinData 实例是零扩展的。例如，给定以下文档：
db.collection.insertOne({ x: BinData(0, "ww=="), binaryValueofA: "11000011" })
$bitsAllClear会将x 之外的所有位视为已清除。
示例
下面的示例将使用包含以下文档的集合：
db.collection.insertMany([ { _id: 1, a: 54, binaryValueofA: "00110110" }, { _id: 2, a: 20, binaryValueofA: "00010100" }, { _id: 3, a: 20.0, binaryValueofA: "00010100" }, { _id: 4, a: BinData(0, "Zg=="), binaryValueofA: "01100110" } ])
位位置数组
以下查询使用$bitsAllClear 操作符符测试字段a 是否在位置1 和位置5 清除了位，其中最低有效位是位置0 。
db.collection.find( { a: { $bitsAllClear: [ 1, 5 ] } } )
查询匹配以下文档：
{ "_id" : 2, "a" : 20, "binaryValueofA" : "00010100" } { "_id" : 3, "a" : 20, "binaryValueofA" : "00010100" }
Integer Bitmask
以下查询使用$bitsAllClear 操作符符测试字段a 是否在位置0 、1 和5 处清除了位（位掩码35 的二进制表示为00100011 ）。
db.collection.find( { a: { $bitsAllClear: 35 } } )
查询匹配以下文档：
{ "_id" : 2, "a" : 20, "binaryValueofA" : "00010100" } { "_id" : 3, "a" : 20, "binaryValueofA" : "00010100" }
BinData Bitmask
以下查询使用$bitsAllClear 操作符：
db.collection.find( { a: { $bitsAllClear: BinData(0, "IA==") } } )
查询：
将
0指定为BinData的第一个值，这表示IA==应解释为二进制。 以二进制表示的 64 进制值IA==为00100000，其中1位于位置 5。使用
$bitsAllCleara05返回文档，其中 字段在二进制值的位置 具有清零位 。
该查询返回以下文档：
{ "_id" : 2, "a" : 20, "binaryValueofA" : "00010100" } { "_id" : 3, "a" : 20, "binaryValueofA" : "00010100" }