$ bitsAnySet_MonogDB 中文网

MongoDB 中文手册

参考 > 参考 > 经营者 > 查询和投影运算符 > 按位查询运算符 > $ bitsAnySet

在本页面

行为
例子

$bitsAnySet¶

3.2版中的新功能。

$bitsAnySet匹配在中设置（即）查询给出的任何位位置的文档。1field

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

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

数值位掩码: 您可以提供一个数字位掩码以与操作数字段匹配。它必须可表示为非负的32位带符号整数。否则， $bitsAnySet将返回错误。
BinData位掩码: 您还可以使用任意大的BinData 实例作为位掩码。
职位清单: 如果查询位位置列表，则每个位置<position>必须为非负整数。位位置0从最低有效位开始。例如，十进制数254将具有以下位位置：

位值	1个	1个	1个	1个	1个	1个	1个	0
位置	7	6	5	4	3	2	1个	0

行为¶

索引¶

查询不能将索引用于$bitsAnySet查询的一部分，尽管查询的其他部分可以使用索引（如果适用）。

浮点值¶

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

注册扩展¶

数字以符号扩展。例如，$bitsAnySet考虑将位位置200 设置为负数-5，但将位位置200清除为正数+5。

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

复制

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

$bitsAnySet会认为外面的所有位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" })

位位置阵列¶

以下查询使用$bitsAnySet运算符测试字段a是否设置了位位置1或位位置5，其中最低有效位是position 0。

复制

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

该查询与以下文档匹配：

复制

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

整数位掩码¶

以下查询使用的$bitsAnySet运算符来测试字段是否a具有设定在位置上的任何位0，1和5 （位掩码的二进制表示35是00100011）。

复制

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

该查询与以下文档匹配：

复制

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

BinData位掩码¶

以下查询使用$bitsAnySet运算符来测试field是否a在位置4和5 （is 的二进制表示）上设置了任何位。BinData(0, "MC==")00110000

复制

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

该查询与以下文档匹配：

复制

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