$bitsAllSet

在本页面

$bitsAllSet匹配查询给出的所有位位置在field中设置(i.e.1)的文档。

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

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

  • 数字位掩码

    • 您可以提供与操作数字段匹配的数字位掩码。它必须可以表示为 non-negative 32-bit 签名的 integer。否则,$bitsAllSet将_return 错误。
  • BinData 位掩码

    • 您还可以使用任意大的BinData实例作为位掩码。
  • 职位清单

    • 如果查询位位置列表,则每个<position>必须是 non-negative integer。位位置从最低有效位开始0。对于 example,decimal 数254将具有以下位位置:
位值11111110
位置76543210

行为

索引

查询不能使用索引作为查询的$bitsAllSet部分,尽管查询的其他部分可以使用索引(如果适用)。

浮点值

$bitsAllSet不会 match 无法表示为 signed 64-bit integer 的数值。如果 value 太大或太小而无法放入有符号的 64-bit integer,或者它有一个小数 component,则可能出现这种情况。

签名扩展

Numbers 符号扩展。对于 example,$bitsAllSet认为位位置200设置为负数-5,但位位置200要清除正数+5

相比之下,BinData实例是 zero-extended。例如,给出以下文档:

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

$bitsAllSet将认为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" })

位位置 Array

以下查询使用$bitsAllSet operator 来测试字段a是否在位置1和位置5处设置了位,其中最低有效位是位置0

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

该查询与以下文档匹配:

{ "_id" : 1, "a" : 54, "binaryValueofA" : "00110110" }
{ "_id" : 4, "a" : BinData(0,"Zg=="), "binaryValueofA" : "01100110" }

Integer Bitmask

以下查询使用$bitsAllSet operator 来测试字段a是否在145位置设置了位(位掩码50的二进制表示是00110010)。

db.collection.find( { a: { $bitsAllSet: 50 } } )

该查询与以下文档匹配:

{ "_id" : 1, "a" : 54, "binaryValueofA" : "00110110" }

BinData 位掩码

以下查询使用$bitsAllSet operator 来测试字段a是否在位置 4 和 5 处设置了位(BinData(0, "MC==")的二进制表示是00110000)。

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

该查询与以下文档匹配:

{ _id: 1, a: 54, binaryValueofA: "00110110" }