$toBool (التحويل إلى منطقي)

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

$toBool (التحويل إلى منطقي)

يحوّل $toBool قيمة إلى قيمة منطقية. الرقم 0 يصبح false وأي رقم غير صفري يصبح true؛ والسلسلتان 'true' و 'false' تتحولان مباشرة؛ والتواريخ تصبح true؛ ويبقى null null. الاستخدامات النموذجية: تطبيع علامات 0/1 من واجهات API إلى حقول منطقية أو توحيد تمثيلات الصدق. وهو مختصر $convert لـ to: bool، دون onError — تحويل القيم غير الصالحة يُسبب خطأً.

📝 الصيغة

{ $toBool: <expression> }

⚙️ المعلمات

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

▶ مثال

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

// $toBool: تحويل علامة 0/1 إلى قيمة منطقية
db.devices.aggregate([
  { $project: {
      active: { $toBool: '$enabled' }
  } }
])

المخرجات：

{ '_id': 1, 'active': true }
{ '_id': 2, 'active': false }

📌 ملاحظات

• 0 يصبح false وغير الصفري true؛ والسلسلة '0' تصبح true
• المدخل الفارغ يُرجع null لا false
• الأنواع غير المدعومة تُسبب خطأً؛ احرس بـ $convert onError

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

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

📚 دروس ذات صلة

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

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

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

من نحن