翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

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

Amazon DocumentDB の `$bitsAllClear`演算子は、フィールドで指定されたすべてのビットがクリアされているドキュメントを照合するために使用されます (0 に設定）。この演算子は、保存されたデータに対してビット単位のオペレーションを実行するのに役立ちます。

**パラメータ**
+ `field`: クリアされている指定されたビットをチェックするフィールド。
+ `value`: チェックするビットを指定する数値ビットマスク、またはチェックするビット位置のリスト。数値ビットマスクは、バイナリ (0b...)、10 進数、16 進数 (0x...)、8 進数 (0o...)、またはバイナリ (BinData) 形式にすることができます。ビット位置のリストでは、最下位ビットの位置は 0 です。

## 例 (MongoDB シェル)
<a name="bitsAllClear-examples"></a>

次の例は、Amazon DocumentDB での `$bitsAllClear`演算子の使用を示しています。

**サンプルドキュメントを作成する**

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

**クエリの例**

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

**出力**

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

クエリは、ビットマスクで指定されたすべてのビット `0b0011` (最下位 2 つのビット) が `bits` フィールドでクリアされているかどうかを確認します。`_id` 2 のドキュメントは、 `bits`フィールドでこれらのビットがクリアされているため、この条件を満たします。

## コードの例
<a name="bitsAllClear-code"></a>

`$bitsAllClear` コマンドを使用するコード例を表示するには、使用する言語のタブを選択します。

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

------