$bit

定義

$bit

$bit演算子は、フィールドのビット単位の更新を実行します。 この演算子は、ビット単位のand 、ビット単位のor 、ビット単位のxor （つまり 排他的論理和）操作。 $bit演算子式を指定するには、次のプロトタイプを使用します。

{ $bit: { <field>: { <and|or|xor>: <int> } } }

この演算子は整数フィールド（32 ビット整数または 64 ビット整数）でのみ使用します。

埋め込みドキュメントまたは配列で<field>を指定するには、 ドット表記 を使用します。

注意

mongosh内のすべての数値は、整数ではなく double です。 mongoshで整数を指定するには、 NumberInt()またはNumberLong()コンストラクターを使用します。 詳しくは、「 Int 32またはLong 」を参照してください。

MongoDB ドライバーが数値を処理する方法については、ドライバーのドキュメント を参照してください。

動作

MongoDB 5.0 以降、$bitなどの更新演算子を空のオペランド式（{ }）と併用しても、mongod でエラーが発生しなくなりました。空の更新を使用すると変更は一切されず、oplog エントリも作成されません（操作は実行されません）。

MongoDB 5.0 以降、更新演算子では名前が文字列ベースのドキュメントフィールドを辞書順に処理します。数値名のフィールドは、数値順に処理されます。詳細については、「更新演算子の動作」を参照してください。

例

次の例では、 switchesコレクションを使用します。

db.switches.insertMany( [
   { _id: 1, expdata: Int32(13) },
   { _id: 2, expdata: Int32(3) },
   { _id: 3, expdata: Int32(1) }
] )

db.switches.updateOne(
   { _id: 1 },
   { $bit: { expdata: { and: Int32( 10 ) } } }
)

1101   // expdata
1010   // Int32(10)
----
1000

{ "_id" : 1, "expdata" : 8 }

db.switches.updateOne(
   { _id: 2 },
   { $bit: { expdata: { or: Int32( 5 ) } } }
)

0111   // expdata
0101   // Int32(5)
----
0111

{ "_id" : 2, "expdata" : 7 }

db.switches.updateOne(
   { _id: 3 },
   { $bit: { expdata: { xor: Int32( 5 ) } } }
)

0001   // expdata
0101   // Int32(5)
----
0100

{ "_id" : 1, "expdata" : 4 }