As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# \$1bit
<a name="bit"></a>

O `$bit` operador no Amazon DocumentDB permite que você execute operações bit a bit nos bits de um determinado campo. Isso pode ser útil para tarefas como definir, limpar ou verificar o estado de bits individuais em um número.

**Parâmetros**
+ `field`: O campo no qual realizar operações bit a bit.
+ `and`: um valor inteiro usado para realizar uma operação AND bit a bit no campo.
+ `or`: um valor inteiro usado para realizar uma operação OR bit a bit no campo.
+ `xor`: um valor inteiro usado para realizar uma operação XOR bit a bit no campo.

## Exemplo (MongoDB Shell)
<a name="bit-examples"></a>

O exemplo a seguir demonstra como usar o `$bit` operador para realizar operações bit a bit em um campo numérico.

**Crie documentos de amostra**

```
db.numbers.insert([
  { "_id": 1, "number": 5 },
  { "_id": 2, "number": 12 }
])
```

**Exemplo de consulta**

```
db.numbers.update(
  { "_id": 1 },
  { "$bit": { "number": { "and": 3 } } }
)
```

**Saída**

```
{
  "_id": 1,
  "number": 1
}
```

Neste exemplo, o `$bit` operador é usado para realizar uma operação AND bit a bit no campo “número” do documento com o `_id` de 1. O resultado é que o valor do campo “número” é definido como 1, que é o resultado da operação AND bit a bit entre o valor original de 5 e o valor 3.

## Exemplos de código
<a name="bit-code"></a>

Para ver um exemplo de código para usar o `$bit` comando, escolha a guia do idioma que você deseja usar:

------
#### [ Node.js ]

```
const { MongoClient } = require('mongodb');

async function main() {
  const client = await MongoClient.connect('mongodb://<username>:<password>@<cluster-endpoint>:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false');
  const db = client.db('test');
  const collection = db.collection('numbers');

  await collection.updateOne(
    { "_id": 1 },
    { "$bit": { "number": { "and": 3 } } }
  );

  const result = await collection.findOne({ "_id": 1 });
  console.log(result);

  await client.close();
}

main();
```

------
#### [ Python ]

```
from pymongo import MongoClient

client = MongoClient('mongodb://<username>:<password>@<cluster-endpoint>:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false')
db = client['test']
collection = db['numbers']

collection.update_one(
    {"_id": 1},
    {"$bit": {"number": {"and": 3}}}
)

result = collection.find_one({"_id": 1})
print(result)

client.close()
```

------