$bitsAnyClear

在本页面

  • $bitsAnyClear
    • 3.2 版中的新功能。

$bitsAnyClear匹配field中查询给出的位置(即0)清晰的文档。

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

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

  • Numeric Bitmask

    • 您可以提供一个数字位掩码以与操作数字段匹配。它必须可表示为非负的 32 位带符号整数。否则,$bitsAnyClear将返回错误。

    • BinData Bitmask

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

      • 如果查询位位置列表,则每个<position>必须为非负整数。位位置从最低有效位0开始。例如,十进制数254将具有以下位位置:
Bit Value11111110
Position76543210

Behavior

Indexes

查询不能将索引用于查询的$bitsAnyClear部分,尽管查询的其他部分也可以使用索引(如果适用)。

浮点值

$bitsAnyClear将与不能表示为带符号的 64 位整数的数值不匹配。如果值太大或太小而无法容纳带符号的 64 位整数,或者具有小数部分,则可能是这种情况。

Sign Extension

数字以符号扩展。例如,$bitsAnyClear认为将位置200设置为负数-5,但将比特位置200清除为正数+5

相反,BinData个实例是零扩展的。例如,给定以下文档:

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

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

Examples

以下示例将使用具有以下文档的集合:

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 clear,其中最低有效位是位置0

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

该查询与以下文档匹配:

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

Integer Bitmask

以下查询使用$bitsAnyClear运算符测试字段a是否在位置015(位掩码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 Bitmask

以下查询使用$bitsAnyClear运算符测试字段a是否在位置 4 和 5 处有任何清除的位(BinData(0, "MC==")的二进制表示形式为00110000)。

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

该查询与以下文档匹配:

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