$toInt (التحويل إلى عدد صحيح 32-بت)

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

$toInt (التحويل إلى عدد صحيح 32-بت)

يحوّل $toInt قيمة إلى عدد صحيح موقع 32-بت (int من BSON). يقبل الأرقام والسلاسل الرقمية والقيم المنطقية؛ ويبقى null null. الاستخدامات النموذجية: توحيد السلاسل الصحيحة من الأنظمة الخارجية أو تقريب الأعداد العشرية إلى أعداد صحيحة. القيم خارج نطاق 32-بت (نحو 2.1 مليار) تُسبب خطأً — استخدم $toLong للأعداد الكبيرة. يجب أن تكون السلاسل صيغ أعداد صحيحة؛ والسلسلة الكسرية مثل '4.5' تُسبب خطأً. وهو مختصر $convert لـ to: int.

📝 الصيغة

{ $toInt: <expression> }

⚙️ المعلمات

القيمة المرجعة：قيمة int؛ null عندما يكون الإدخال null

▶ مثال

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

// $toInt: تحليل سلسلة كمية إلى عدد صحيح
db.orders.aggregate([
  { $project: {
      qty: { $toInt: '$qtyStr' }
  } }
])

المخرجات：

{ '_id': 1, 'qty': 3 }

📌 ملاحظات

• نطاق 32-بت نحو 2.1 مليار؛ وما بعده يُسبب خطأً، لذا استخدم $toLong للأعداد الكبيرة
• يجب أن تكون السلاسل صيغ أعداد صحيحة؛ و '4.5' تُسبب خطأً
• true تصبح 1 و false تصبح 0

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

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

📚 دروس ذات صلة

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

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

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

من نحن