Docs 菜单

Docs 主页 → 开发应用程序 → MongoDB Manual

$bitsAnyClear

在此页面上

  • 行为
  • 举例
$bitsAnyClear

版本 3.2 中的新增功能。

$bitsAnyClear匹配field中查询给出的任何位位置均为清除（即0 ）的文档。

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

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

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

行为

索引

查询不能对查询的$bitsAnyClear部分使用索引，但查询的其他部分可以使用索引（如果适用）。

浮点值

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

符号扩展

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

相反， BinData实例是零扩展的。 例如，给定以下文档：

db.collection.save({ x: BinData(0, "ww=="), binaryValueofA: "11000011" })

$bitsAnyClear会将x以外的所有位视为已清除。

举例

下面的示例将使用包含以下文档的集合：

db.collection.save({ _id: 1, a: 54, binaryValueofA: "00110110" })
db.collection.save({ _id: 2, a: 20, binaryValueofA: "00010100" })
db.collection.save({ _id: 3, a: 20.0, binaryValueofA: "00010100" })
db.collection.save({ _id: 4, a: BinData(0, "Zg=="), binaryValueofA: "01100110" })

位位置数组

以下查询使用$bitsAnyClear操作符来测试字段a是否已清除位位置1或位位置5 ，其中最低有效位是位置0 。

db.collection.find( { a: { $bitsAnyClear: [ 1, 5 ] } } )

查询匹配以下文档：

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

整数位掩码

以下查询使用$bitsAnyClear操作符测试字段a在位置0 、 1和5处是否有任何位被清除（位掩码35的二进制表示为00100011 ）。

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

查询匹配以下文档：

{ "_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" }

BinData 位掩码

以下查询使用$bitsAnyClear操作符测试字段a在位置4和5是否有任何位被清除（ BinData(0, "MA==")的二进制表示为00110000 ）。

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

查询匹配以下文档：

{ "_id" : 2, "a" : 20, "binaryValueofA" : "00010100" }
{ "_id" : 3, "a" : 20.0, "binaryValueofA" : "00010100" }
{ "_id" : 4, "a" : BinData(0,"Zg=="), "binaryValueofA" : "01100110" }
← $bitsAllSet
$bitsAnySet →

在此页面上