$bitsAllClear

項目一覧

動作

$bitsAllClear

バージョン 3.2 で追加。

$bitsAllClearは、クエリによって指定されたすべてのビット位置がクリアされているドキュメント（ 0のfield ）。

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

field値は数値またはBinDataインスタンスのいずれかである必要があります。そうしないと、 $bitsAllClearは現在のドキュメントと一致しません。

数値ビットマスク: オペランドフィールドと照合するための数値ビットマスクを指定できます。ビットマスクは、負でない64ビットの符号付き整数である必要があります。それ以外の場合、 $bitsAllClearはエラーを返します。
BinData Bitmask: 任意の大きなBinDataインスタンスをビットマスクとして使用することもできます。
位置リスト: ビット位置のリストをクエリする場合、各<position>は負でない整数である必要があります。ビット位置は最下位ビットの0から始まります。たとえば、10 進数254は次のビット位置を持ちます。

ビット値	1	1	1	1	1	1	1	0
位置	7	6	5	4	3	2	1	0

動作

システムのエンディアン性は、マシンのアーキテクチャによって異なります。 BSON データ内の数値は常にリトルエンディアンとして保存されます。システムがビッグエンディアンの場合、数値データはビッグエンディアンとリトルエンディアンの間で変換されます。

ビットテストマッチ式演算子のコンテキストでは、次のようになります。

BinData値はビットマスクとして機能とは、任意の長さの符号なしのリトルエンディアン数であるかのように解釈されます。アドレス指定可能な最小バイトは、常に最下位バイトとして解釈されます。同様に、 BinData内の最上位バイトは、常に最上位バイトとして解釈されます。

Indexes

クエリはクエリの$bitsAllClear部分にインデックスを使用できませんが、クエリの他の部分ではインデックスを使用できます（該当する場合）。

浮動小数点値

$bitsAllClear は、符号付き 64 ビット整数として表できない数値と一致しません。これは、値が符号付き 64 ビット整数に収まらないほど大きいか小さい場合、または端数コンポーネントがある場合に当てはまります。

符号拡張

数値は符号拡張されます。たとえば、 $bitsAllClearでは、負の数-5にはビット位置200が設定されていると見なされますが、正の数+5にはビット位置200がクリアされていると見なされます。

対照的に、 BinDataインスタンスはゼロ拡張です。たとえば、次のドキュメントがあるとします。

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

$bitsAllClear 、 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" })

ビット位置配列

次のクエリでは、 $bitsAllClear演算子を使用して、フィールドaのビットが位置1と位置5でクリアされているかどうかをテストします。ここで示した最下位ビットは位置0です。

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

クエリは、次のドキュメントと一致します。

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

Integer Bitmask

次のクエリは$bitsAllClear演算子を使用して、フィールドaの位置0 、 1 、および5でビットがクリアされているかどうかをテストします（ビットマスク35のバイナリ表現は00100011です）。

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

クエリは、次のドキュメントと一致します。

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

BinData Bitmask

次のクエリでは$bitsAllClear演算子が使用されます。

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

クエリでは以下の操作が実行されます。

BinDataの最初の値として0を指定します。これは、 IA==をバイナリとして解釈する必要があることを示しています。バイナリ内の base 64 の値IA==は00100000で、位置 5 には1があります。
$bitsAllClearを使用して、 aフィールドがバイナリ値の位置5にクリアビット0を持つドキュメントを返します。

このクエリでは次のドキュメントが返されます。

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

戻る

ビットクエリ

$bitsAllSet