close() (إغلاق مؤشر)
آخر تحديث: 2026-10-09
close() (إغلاق مؤشر)
تُغلق close() مؤشرًا مبكرًا وتحرر موارد الخادم: `db.users.find().close()`. استدعها عند عدم الحاجة إلى المستندات المتبقية، ما يوقف الخادم عن بث مزيد من الدفعات. تُعيد null؛ وإغلاق مؤشر منفد أو مغلق أصلًا لا يرفع خطأً.
| الفئة | المؤشر |
|---|---|
| إصدار MongoDB | 1.0+ |
| لغة المثال | mongosh (الطرفية) |
📝 الصيغة
db.<collection>.find(<filter>).close()القيمة المرجعة：null.
▶ مثال
نفّذ الأوامر التالية في mongosh المحلي لديك (يتطلب تشغيل mongod):
// close: معالجة المستند الأول ثم الإغلاق
const cursor = db.users.find()
if (cursor.hasNext()) {
print(cursor.next().name)
}
cursor.close()المخرجات：
Alice📌 ملاحظات
- الإغلاق المبكر الصريح يحرر موارد الخادم
- لا يمكن التكرار على مؤشر مغلق
- mongosh ومعظم المشغلات تغلق تلقائيًا عند النفاد أو جمع القمامة
🏷️ وسوم ذات صلة
💡 حالات ذات صلة
📚 دروس ذات صلة
❓ الأسئلة الشائعة
Qهل يمكنني التكرار بعد close()؟
Aلا — بعد close() يصبح المؤشر غير قابل للاستخدام؛ أعد تشغيل الاستعلام.
Qماذا يحدث إذا لم أستدعِ close() أبدًا؟
Aعادةً لا شيء — تُنظَّف المؤشرات عند النفاد أو انتهاء المهلة؛ الإغلاق اليدوي أنظف فقط عند الخروج المبكر.
Qماذا تُعيد close()؟
Aتُعيد null؛ تُتجاهل النتيجة عادةً.
