$bitsAllClear (كل البتات مصفَّرة)
آخر تحديث: 2026-10-09
$bitsAllClear (كل البتات مصفَّرة)
يطابق $bitsAllClear المستندات التي تكون فيها كل البتات في المواضع المعطاة 0. فالعبارة `{ flags: { $bitsAllClear: 3 } }` (الثنائي 11) تطابق المستندات التي تكون فيها البتتان 0 و1 كلتاهما 0. مفيد للتحقق من أن مجموعة أعلام مطفأة بالكامل. يعمل على الأعداد الصحيحة وBinData فقط.
| الفئة | البتي |
|---|---|
| إصدار MongoDB | 3.2+ |
| لغة المثال | mongosh (الطرفية) |
📝 الصيغة
{ <field>: { $bitsAllClear: <bitmask or position array> } }
⚙️ المعلمات
| حقل | حقل العدد الصحيح أو BinData المراد مطابقته. |
|---|---|
| قناع بتات | قناع بتات صحيح أو مصفوفة مواضع، مثل 3 أو [0, 1]. |
القيمة المرجعة:مؤشر المستندات المطابقة
▶ مثال
نفّذ الأوامر التالية في mongosh المحلي لديك (يتطلب تشغيل mongod):
// $bitsAllClear: البتتان 0 و1 كلتاهما 0
// 3 بالثنائي هي 11
db.users.find({ flags: { $bitsAllClear: 3 } })
// المكافئ: مصفوفة المواضع
db.users.find({ flags: { $bitsAllClear: [0, 1] } })
المخرجات:
// يُرجع المستخدمين الذين تكون البتتان 0 و1 في flags مصفرتين معًا
📌 ملاحظات
- مكمل $bitsAllSet: الكل-0 مقابل الكل-1
- الأعداد الصحيحة (int، long) وBinData فقط
- يفحص أيضًا بتة واحدة: { $bitsAllClear: [n] }
🏷️ وسوم ذات صلة
💡 حالات ذات صلة
مزيد من الحالات العملية قريبًا.
📚 دروس ذات صلة
❓ الأسئلة الشائعة
Qكيف أتحقق من أن بتة ما هي 0؟
Aاستخدم $bitsAllClear: [موضع]، مثل [2] الذي يختبر أن البتة 2 تساوي 0.
Qما الفرق بين $bitsAllClear و $bitsAnyClear؟
Aيتطلب $bitsAllClear أن تكون كل بتة مدرجة 0؛ بينما يكتفي $bitsAnyClear بواحدة.
Qأي الأنواع مدعومة؟
Aفقط int و long و BinData.