count() (العدّ على مؤشر)
آخر تحديث: 2026-10-09
count() (العدّ على مؤشر)
تعدّ count() المستندات التي سيعيدها المؤشر الحالي: `db.users.find({ age: { $gt: 20 } }).count()`. تعمل على المؤشر، لذا يُطبَّق مرشح find() أولًا. لاحظ أن هذه الطريقة مهجورة — البديل الرسمي `db.users.countDocuments()` مكافئ وأكثر دقة على العناقيد المجزأة.
| الفئة | المؤشر |
|---|---|
| إصدار MongoDB | 1.0+ |
| لغة المثال | mongosh (الطرفية) |
📝 الصيغة
db.<collection>.find(<filter>).count()
القيمة المرجعة:عدد المستندات التي سيُرجعها المؤشر (عدد صحيح).
▶ مثال
نفّذ الأوامر التالية في mongosh المحلي لديك (يتطلب تشغيل mongod):
// count: عدّ المستخدمين الأكبر من 20 عامًا
const n = db.users.find({ age: { $gt: 20 } }).count()
print(n)
المخرجات:
35
📌 ملاحظات
- مهجورة — استخدم countDocuments() في الكود الجديد
- تكافئ دلاليًا countDocuments() لكنها قد تكون أقل دقة على الشرائح
- count() لا تستهلك المؤشر؛ يمكن مواصلة التكرار
🏷️ وسوم ذات صلة
💡 حالات ذات صلة
📚 دروس ذات صلة
❓ الأسئلة الشائعة
Qهل ما زال count() الخاص بالمؤشر قابلًا للاستخدام؟
Aيعمل لكنه مهجور؛ يجب أن يستخدم الكود الجديد countDocuments()، وهي مكافئة وأكثر دقة.
Qهل تختلف count() عن countDocuments()؟
Aالدلالات هي نفسها عملية العدّ الدقيق؛ countDocuments() هي البديل الموصى به والأكثر موثوقية على الشرائح.
Qهل يمكنني جلب البيانات بعد count()؟
Aنعم — count() تعدّ فقط وتبقي المؤشر قابلاً للاستخدام بـ toArray()/forEach() بعدها.