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.

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

L'`$bitsAnySet`opérateur d'Amazon DocumentDB est utilisé pour interroger des documents dont au moins un bit est défini sur 1 dans les bits spécifiés dans un champ. Cet opérateur vous permet d'effectuer des opérations bit par bit sur les valeurs stockées dans les champs, ce qui permet d'interroger et d'analyser efficacement les données présentant des caractéristiques au niveau du bit.

**Paramètres**
+ `field`: nom du champ auquel appliquer l'opération bit par bit.
+ `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 de bits 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="bitsAnySet-examples"></a>

L'exemple suivant montre comment utiliser l'`$bitsAnySet`opérateur pour rechercher des documents dans lesquels au moins un bit est défini dans le `flags` champ.

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

```
db.collection.insertMany([
  { _id: 1, flags: 0b1010 },
  { _id: 2, flags: 0b1100 },
  { _id: 3, flags: 0b0011 },
  { _id: 4, flags: 0b0100 }
]);
```

**Exemple de requête**

```
db.collection.find({
  flags: { $bitsAnySet: 0b1010 }
})
```

**Sortie**

```
{ "_id" : 1, "flags" : 10 }
{ "_id" : 2, "flags" : 12 }
{ "_id" : 3, "flags" : 3 }
```

La requête renvoie les documents dans lesquels au moins un des bits spécifiés dans le masque de bits `0b1010` est défini dans le `flags` champ.

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

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

------
#### [ 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('collection');

  const result = await collection.find({
    flags: { $bitsAnySet: 0b1010 }
  }).toArray();

  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['collection']

result = list(collection.find({
    'flags': { '$bitsAnySet': 0b1010 }
}))

print(result)

client.close()
```

------