Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

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

L'`$bitsAllClear`opérateur dans Amazon DocumentDB est utilisé pour faire correspondre les documents dans lesquels tous les bits spécifiés dans un champ sont effacés (définis sur 0). Cet opérateur peut être utile pour effectuer des opérations au niveau du bit sur des données stockées.

**Paramètres**
+ `field`: champ permettant de vérifier si les bits spécifiés sont effacés.
+ `value`: masque de bits numérique qui indique quels bits doivent être vérifiés, ou une liste de positions de bits à vérifier. Un masque numérique peut être binaire (0b...), décimal, hexadécimal (0x...), octal (0o...) ou binaire (). BinData Dans une liste de positions de bits, la position du bit le moins significatif est 0.

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

L'exemple suivant illustre l'utilisation de l'`$bitsAllClear`opérateur dans Amazon DocumentDB.

**Création d'exemples de documents**

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

**Exemple de requête**

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

**Sortie**

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

La requête vérifie si tous les bits spécifiés par le masque de bits `0b0011` (les deux bits les moins significatifs) sont effacés dans le `bits` champ. Le document comportant `_id` 2 satisfait à cette condition, car ces bits sont effacés `bits` dans son champ.

## Exemples de code
<a name="bitsAllClear-code"></a>

Pour afficher un exemple de code d'utilisation de la `$bitsAllClear` commande, choisissez l'onglet correspondant à la langue que vous souhaitez utiliser :

------
#### [ 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()
```

------