Docs 菜单

Docs 主页开发应用程序MongoDB Manual

$bitsAllClear

在此页面上

  • 行为
  • 举例
$bitsAllClear

$bitsAllClear匹配field中查询给出的所有位位置均已清除(即0 )的文档。

{ <field>: { $bitsAllClear: <numeric bitmask> } }
{ <field>: { $bitsAllClear: < BinData bitmask> } }
{ <field>: { $bitsAllClear: [ <position1>, <position2>, ... ] } }

field值必须是数字或BinData实例。否则, $bitsAllClear将不匹配当前文档。

数字位掩码
您可以提供与操作数字段匹配的数字位掩码。位掩码必须是非负64位带符号整数。否则, $bitsAllClear将返回错误。
BinData 位掩码
您也可以使用任意大的 BinData 实例作为位掩码。
位置列表
如果查询位位置列表,每个 <position> 必须是非负整数。位位置从最低有效位 0 开始。例如,十进制数 254 的位数位置如下:
位值
1
1
1
1
1
1
1
0
Position
7
6
5
4
3
2
1
0

查询不能对查询的$bitsAllClear部分使用索引,但查询的其他部分可以使用索引(如果适用)。

$bitsAllClear 不会匹配无法表示为带符号的 64 位整数的数值。如果某个值太大或太小,超出带符号 64 位整数的范围,或者该值包含小数部分,则可能会出现这种情况。

数字进行符号扩展。例如, $bitsAllClear认为对负数-5的位位置200已设置,但对正数+5的位位置200为清除。

相反,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" }

以下查询使用$bitsAllClear操作符测试字段a是否在位置015处清除了位(位掩码35的二进制表示为00100011 )。

db.collection.find( { a: { $bitsAllClear: 35 } } )

查询匹配以下文档:

{ "_id" : 2, "a" : 20, "binaryValueofA" : "00010100" }
{ "_id" : 3, "a" : 20, "binaryValueofA" : "00010100" }

以下查询使用$bitsAllClear操作符:

db.collection.find( { a: { $bitsAllClear: BinData(0, "IA==") } } )

查询:

  • 0指定为BinData的第一个值,这表示IA==应解释为二进制。 以二进制表示的 64 进制值IA==00100000 ,其中1位于位置 5。

  • 使用$bitsAllClear返回文档,其中a字段在二进制值的位置5具有清零位0

该查询返回以下文档:

{ "_id" : 2, "a" : 20, "binaryValueofA" : "00010100" }
{ "_id" : 3, "a" : 20, "binaryValueofA" : "00010100" }
← 按位查询操作符

在此页面上