$convert (تحويل الأنواع)

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

$convert (تحويل الأنواع)

يحوّل $convert قيمة إلى نوع BSON مستهدف وهو نقطة الدخول الرئيسية لتحويلات الأنواع. يقبل المعامل to أنواع double و string و objectId و bool و date و int و long و decimal. فشل التحويل يُسبب خطأً افتراضيًا، لكن onError يوفّر بديلًا؛ والمدخل الفارغ يُرجع null افتراضيًا ويتجاوز onNull ذلك. الاستخدامات النموذجية: تحويل سلاسل رقمية إلى أرقام للحسابات أو تحليل سلاسل التواريخ إلى تواريخ. مقارنةً بالمختصرات مثل $toInt، يضيف $convert معالجة الفشل.

📝 الصيغة

{ $convert: { input: <expression>, to: <type>, onError: <fallback>, onNull: <nullResult> } }

⚙️ المعلمات

القيمة المرجعة：القيمة المحوَّلة؛ يُطبَّق onError/onNull عند الفشل أو null

▶ مثال

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

// $convert: تحليل سعر نصي إلى رقم، البديل 0
db.products.aggregate([
  { $project: {
      priceNum: { $convert: { input: '$priceStr', to: 'double', onError: 0 } }
  } }
])

المخرجات：

{ '_id': 1, 'priceNum': 19.9 }
{ '_id': 2, 'priceNum': 0 }

📌 ملاحظات

• الفشل يُسبب خطأً افتراضيًا؛ وفّر onError دائمًا في الإنتاج
• المدخل الفارغ يُرجع null؛ تجاوز ذلك بـ onNull
• $toInt/$toDouble وغيرها مختصرات لـ $convert لكنها تفتقر إلى onError

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

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

📚 دروس ذات صلة

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

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

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

من نحن