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