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