Add reference Markdown: operators/bitwise-update

reference/operators/bitwise-update/$bit.md

@@ -0,0 +1,228 @@
+---
+title: $bit
+description: The `$bit` operator is used to perform bitwise operations on integer values.
+type: operators
+category: bitwise-update
+---
+
+# $bit
+
+The `$bit` operator is used to perform bitwise operations on integer values. It can be used to update integer fields in documents by applying bitwise AND, OR, and XOR operations. Bitwise operators like $bit aren't designed for incrementing values, but for manipulating bits directly (like checking, setting, or clearing specific bits).
+
+## Syntax
+
+```javascript
+{
+    $bit: {
+        < field >: {
+            < operator >: < number >
+        }
+    }
+}
+```
+
+## Parameters
+
+| Parameter | Description |
+| --- | --- |
+| **`<field>`** | The field to perform the bitwise operation on. |
+| **`<operator>`** | The bitwise operation to perform. Can be one of: `and`, `or`, `xor`. |
+| **`<number>`** | The number to use for the bitwise operation. |
+
+## Examples
+
+Consider this sample document from the stores collection.
+
+```json
+{
+    "_id": "0fcc0bf0-ed18-4ab8-b558-9848e18058f4",
+    "name": "First Up Consultants | Beverage Shop - Satterfieldmouth",
+    "location": {
+        "lat": -89.2384,
+        "lon": -46.4012
+    },
+    "staff": {
+        "totalStaff": {
+            "fullTime": 8,
+            "partTime": 20
+        }
+    },
+    "sales": {
+        "totalSales": 75670,
+        "salesByCategory": [
+            {
+                "categoryName": "Wine Accessories",
+                "totalSales": 34440
+            },
+            {
+                "categoryName": "Bitters",
+                "totalSales": 39496
+            },
+            {
+                "categoryName": "Rum",
+                "totalSales": 1734
+            }
+        ]
+    },
+    "promotionEvents": [
+        {
+            "eventName": "Unbeatable Bargain Bash",
+            "promotionalDates": {
+                "startDate": {
+                    "Year": 2024,
+                    "Month": 6,
+                    "Day": 23
+                },
+                "endDate": {
+                    "Year": 2024,
+                    "Month": 7,
+                    "Day": 2
+                }
+            },
+            "discounts": [
+                {
+                    "categoryName": "Whiskey",
+                    "discountPercentage": 7
+                },
+                {
+                    "categoryName": "Bitters",
+                    "discountPercentage": 15
+                },
+                {
+                    "categoryName": "Brandy",
+                    "discountPercentage": 8
+                },
+                {
+                    "categoryName": "Sports Drinks",
+                    "discountPercentage": 22
+                },
+                {
+                    "categoryName": "Vodka",
+                    "discountPercentage": 19
+                }
+            ]
+        },
+        {
+            "eventName": "Steal of a Deal Days",
+            "promotionalDates": {
+                "startDate": {
+                    "Year": 2024,
+                    "Month": 9,
+                    "Day": 21
+                },
+                "endDate": {
+                    "Year": 2024,
+                    "Month": 9,
+                    "Day": 29
+                }
+            },
+            "discounts": [
+                {
+                    "categoryName": "Organic Wine",
+                    "discountPercentage": 19
+                },
+                {
+                    "categoryName": "White Wine",
+                    "discountPercentage": 20
+                },
+                {
+                    "categoryName": "Sparkling Wine",
+                    "discountPercentage": 19
+                },
+                {
+                    "categoryName": "Whiskey",
+                    "discountPercentage": 17
+                },
+                {
+                    "categoryName": "Vodka",
+                    "discountPercentage": 23
+                }
+            ]
+        }
+    ]
+}
+```
+
+### Example 1: Perform a bitwise AND operation on the `partTime` field in `totalStaff`
+
+```javascript
+db.stores.updateOne({
+    _id: "7954bd5c-9ac2-4c10-bb7a-2b79bd0963c5"
+}, {
+    $bit: {
+        "staff.totalStaff.partTime": {
+            and: 1
+        }
+    }
+})
+```
+
+This query returns the following result.
+
+```json
+[
+  {
+    "acknowledged": true,
+    "insertedId": null,
+    "matchedCount": "1",
+    "modifiedCount": "1",
+    "upsertedCount": 0
+  }
+]
+```
+
+### Example 2:  Perform a bitwise OR operation on the `partTime` field in `totalStaff`
+
+```javascript
+db.stores.updateOne({
+    _id: "7954bd5c-9ac2-4c10-bb7a-2b79bd0963c5"
+}, {
+    $bit: {
+        "staff.totalStaff.partTime": {
+            "or": 1
+        }
+    }
+})
+```
+
+This query returns the following result.
+
+```json
+[
+  {
+    "acknowledged": true,
+    "insertedId": null,
+    "matchedCount": "1",
+    "modifiedCount": "1",
+    "upsertedCount": 0
+  }
+]
+```
+
+### Example 3: Perform a bitwise XOR operation on the `partTime` field in `totalStaff`
+
+```javascript
+db.stores.updateOne({
+    _id: "7954bd5c-9ac2-4c10-bb7a-2b79bd0963c5"
+}, {
+    $bit: {
+        "staff.totalStaff.partTime": {
+            "xor": 1
+        }
+    }
+})
+```
+
+This query returns the following result.
+
+```json
+[
+  {
+    "acknowledged": true,
+    "insertedId": null,
+    "matchedCount": "1",
+    "modifiedCount": "1",
+    "upsertedCount": 0
+  }
+]
+```