$allElementsTrue (التحقق من أن كل العناصر صادقة)
آخر تحديث: 2026-10-09
$allElementsTrue (التحقق من أن كل العناصر صادقة)
يُرجع $allElementsTrue true فقط إذا كان كل عنصر في مصفوفة صادقًا. المصفوفة الفارغة تُرجع true، وفق اصطلاح التكميم الشامل. الاستخدامات النموذجية: التحقق من أن كل عنصر في الطلب متوفر بالمخزون أو أن المستخدم حدد كل الخيارات المطلوبة. يأخذ وسيطة مصفوفة واحدة، وتتبع العناصر قواعد الصدق في MongoDB: 0 والسلسلة الفارغة و null و false كاذبة، وكل ما عدا ذلك صادق. وهو مقابل $anyElementTrue.
| الفئة | المجموعة والشرط والتحويل |
|---|---|
| إصدار MongoDB | 1.0+ |
| لغة المثال | mongosh (الطرفية) |
📝 الصيغة
{ $allElementsTrue: [ <array> ] }⚙️ المعلمات
| مصفوفة | المصفوفة المراد فحصها؛ تُحكَم العناصر حسب كونها صحيحة. |
|---|
القيمة المرجعة：true عندما تكون كل العناصر صحيحة؛ والمصفوفة الفارغة تُرجع true
▶ مثال
نفّذ الأوامر التالية في mongosh المحلي لديك (يتطلب تشغيل mongod):
// $allElementsTrue: التحقق من أن كل عنصر متوفر بالمخزون
db.orders.aggregate([
{ $project: {
allInStock: { $allElementsTrue: ['$inStockFlags'] }
} }
])المخرجات：
{ '_id': 1, 'allInStock': true }
{ '_id': 2, 'allInStock': false }📌 ملاحظات
- المصفوفة الفارغة تُرجع true على نحو غير بديهي؛ ادمجها مع $size لاكتشاف الفراغ
- القيم الكاذبة هي 0 و '' و null و false؛ وكل ما عدا ذلك صادق
- يقبل المصفوفات فقط؛ والوسائط غير المصفوفية تُسبب خطأً
🏷️ وسوم ذات صلة
💡 حالات ذات صلة
مزيد من الحالات العملية قريبًا.
📚 دروس ذات صلة
❓ الأسئلة الشائعة
Qماذا تُرجع المصفوفة الفارغة؟
Aتُرجع true بالتكميم الشامل؛ استخدم $size لفحوصات الفراغ.
Qأي القيم كاذبة؟
A0 والسلسلة الفارغة و null و false؛ وأي شيء آخر، بما فيها السلسلة '0'، صادق.
Qهل يمكنه فحص حقول مصفوفات الكائنات؟
Aاستخرج الحقل إلى مصفوفة منطقية بـ $map أولًا، ثم مرّره.
