$indexOfArray (العثور على فهرس عنصر في مصفوفة)

آخر تحديث: 2026-10-09

$indexOfArray (العثور على فهرس عنصر في مصفوفة)

يُرجع $indexOfArray فهرس أول ظهور لقيمة في مصفوفة، أو -1 عند غيابها. تشمل الاستخدامات النموذجية التحقق من وجود وسم معين وتحديد موقع عنصر لقراءته عبر $arrayElemAt. تحصر الوسيطات الاختيارية البحث في نطاق فهارس start/end. وهو نظير المصفوفات لـ $indexOfBytes/$indexOfCP اللذين يعملان على السلاسل النصية. تستخدم المطابقة مساواة صارمة، لذا يجب أن تتطابق الكائنات ككل.

📝 الصيغة

{ $indexOfArray: [ <array>, <searchValue>, <start>, <end> ] }

⚙️ المعلمات

القيمة المرجعة：فهرس أول تطابق، أو -1 عند عدم العثور عليه

▶ مثال

نفّذ الأوامر التالية في mongosh المحلي لديك (يتطلب تشغيل mongod):

// $indexOfArray: تحديد موقع الوسم 'urgent'
db.tasks.aggregate([
  { $project: {
      urgentPos: { $indexOfArray: ['$tags', 'urgent'] }
  } }
])

المخرجات：

{ '_id': 1, 'urgentPos': 2 }
{ '_id': 2, 'urgentPos': -1 }

📌 ملاحظات

• يُرجع أول تطابق فقط؛ وتُتجاهل التكرارات اللاحقة
• النطاق مغلق من اليسار ومفتوح من اليمين: start شاملة و end حصرية
• عدم العثور يُرجع -1، وهو ما يمكن أن يقود فحوصات الوجود

🏷️ وسوم ذات صلة

💡 حالات ذات صلة

📚 دروس ذات صلة

❓ الأسئلة الشائعة

فريق Web-Tutorial التقني

منصة دروس برمجية يديرها عدة مطورين. كل درس يتم كتابته ومراجعته بواسطة مطورين متخصصين في المجال. نعمل على ضمان دقة وموثوقية المحتوى — إذا لاحظت أي مشكلة، فيرجى إخبارنا.

من نحن