Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

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

L'`$bitsAllClear`operatore in Amazon DocumentDB viene utilizzato per abbinare i documenti in cui tutti i bit specificati in un campo sono cancellati (impostato su 0). Questo operatore può essere utile per eseguire operazioni bit per bit sui dati archiviati.

**Parametri**
+ `field`: Il campo per verificare che i bit specificati vengano cancellati.
+ `value`: La maschera di bit numerica che specifica quali bit devono essere controllati o un elenco di posizioni dei bit da controllare. Una maschera di bit numerica può essere in forma binaria (0b...), decimale, esadecimale (0x...), ottale (0o...) o binaria (). BinData In un elenco di posizioni di bit, la posizione del bit meno significativo è 0.

## Esempio (MongoDB Shell)
<a name="bitsAllClear-examples"></a>

L'esempio seguente dimostra l'utilizzo dell'`$bitsAllClear`operatore in Amazon DocumentDB.

**Crea documenti di esempio**

```
db.collection.insertMany([
  { _id: 1, bits: 0b1010 },
  { _id: 2, bits: 0b1100 },
  { _id: 3, bits: 0b0101 }
]);
```

**Esempio di query**

```
db.collection.find({
  bits: { $bitsAllClear: 0b0011 }
})
```

**Output**

```
{ "_id" : 2, "bits" : 12 }
```

La query verifica se tutti i bit specificati dalla maschera di bit `0b0011` (i due bit meno significativi) sono cancellati nel campo. `bits` Il documento con `_id` 2 soddisfa questa condizione, poiché tali bit `bits` sono stati cancellati nel campo.

## Esempi di codice
<a name="bitsAllClear-code"></a>

Per visualizzare un esempio di codice per l'utilizzo del `$bitsAllClear` comando, scegliete la scheda relativa alla lingua che desiderate utilizzare:

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

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

async function example() {
  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('collection');

  const result = await collection.find({
    bits: { $bitsAllClear: 0b0011 }
  }).toArray();

  console.log(result);

  await client.close();
}

example();
```

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

```
from pymongo import MongoClient

def example():
    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['collection']

    result = list(collection.find({
        'bits': { '$bitsAllClear': 0b0011 }
    }))

    print(result)

    client.close()

example()
```

------