$bit

Definição

$bit

O operador $bit executa uma atualização bitwise de um campo. O operador aceita bitwise and, bitwise or e bitwise xor (ou seja operações exclusivas ou). Para especificar uma expressão de operador $bit , use o protótipo abaixo:

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

Use este operador apenas com campos inteiros (inteiro de 32 bits ou inteiro de 64 bits).

Para especificar um <field> em um documento incorporado ou em uma array, use notação de ponto.

Observação

Todos os números em mongosh são duplos, não inteiros. Use o NumberInt() ou o NumberLong() construtor para especificar inteiros. Consulte Int32 ou Long para obter mais informações.

Comportamento

A partir do MongoDB 5.0, mongod não gera mais um erro ao usar um operador de atualização como $bit com uma expressão de operando vazia ( { } ). Uma atualização vazia não resulta em alteração e nenhuma entrada no oplog é criada (o que significa que é sem operação).

A partir do MongoDB 5.0, os operadores de atualização processam campos de documento com nomes baseados em cadeia de caracteres em ordem lexicográfica. Os campos com nomes numéricos são processados em ordem numérica. Consulte Atualizar Comportamento de Operadores para detalhes.

Exemplos

Os exemplos a seguir usam a coleção 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 }