$bit

Definição

$bit

O operador $bit executa uma atualização bitwise de um campo. O operador oferece suporte a operações bitwise and, bitwise or e bitwise xor (ou seja, exclusivo 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 a 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 NumberInt ou NumberLong para obter mais informações.

Comportamento

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

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 }