Docs 菜单
Docs 主页
/
MongoDB Manual
/ / / /

$bitsAllSet

在此页面上

  • 行为
  • 示例
$bitsAllSet

$bitsAllSet匹配查询给出的所有位位置均已设置的文档(即 1中的 )。field

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

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

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

系统的字节序取决于机器的架构。 BSON数据中的数字始终存储为小端,如果您的系统是大端,这意味着数字数据会在大端和小端之间转换。

在位测试匹配表达式操作符的上下文中:

BinData值充当 位掩码 和 被解释为任意长度的无符号小端数。最低可寻址字节始终被解释为最低有效字节。 同样, BinData中的最高可寻址字节始终被解释为最高有效字节。

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

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

数字使用符号进行扩展。例如,$bitsAllSet 认为,对于负数 -5,位位置 200 已设置,而对于正数 +5,位位置 200 已清除。

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

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" })

以下查询使用$bitsAllSet操作符来测试字段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" }

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

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

查询匹配以下文档:

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

以下查询使用$bitsAllSet操作符来测试字段a是否在位置45处设置了位( BinData(0, "MA==")的二进制表示为00110000 )。

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

查询匹配以下文档:

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

后退

$bitsAllClear

在此页面上