$mul (الضرب)
آخر تحديث: 2026-10-09
$mul (الضرب)
يضرب $mul قيمة حقل بالمعامل المعطى. فالعبارة `{ $mul: { price: 0.9 } }` تطبق خصمًا 10%؛ و`{ $mul: { quantity: 2 } }` تضاعف. بالنسبة لحقل مفقود تُعامل النتيجة كأنها مضروبة في صفر، لذا يُنشأ الحقل بقيمة 0. الحقول غير الرقمية ترمي خطأ. ذري؛ مفيد لتحجيم الأسعار أو الأوزان.
| الفئة | تحديث الحقل |
|---|---|
| إصدار MongoDB | 2.6+ |
| لغة المثال | mongosh (الطرفية) |
📝 الصيغة
{ $mul: { <field>: <factor> } }
⚙️ المعلمات
| حقل | الحقل الرقمي المراد ضربه. |
|---|---|
| المضاعف | معامل الضرب؛ يُسمح بالعشري أو السالب. |
القيمة المرجعة:نتيجة التحديث
▶ مثال
نفّذ الأوامر التالية في mongosh المحلي لديك (يتطلب تشغيل mongod):
// $mul: خصم 10% على السعر
// 100 تصبح 90
db.products.updateOne(
{ _id: 1 },
{ $mul: { price: 0.9 } }
)
// مضاعفة الكمية
db.products.updateOne(
{ _id: 2 },
{ $mul: { qty: 2 } }
)
المخرجات:
// يُضرب price في 0.9 وqty في 2؛ الحقول المفقودة تُنشأ بقيمة 0
📌 ملاحظات
- الحقل المفقود يُنشأ بقيمة 0 (دلالات الضرب في صفر)
- الحقول غير الرقمية ترمي خطأ
- مثل $inc، إنها عملية ذرية
🏷️ وسوم ذات صلة
💡 حالات ذات صلة
📚 دروس ذات صلة
❓ الأسئلة الشائعة
Qماذا يحدث إذا كان حقل $mul مفقودًا؟
Aيُعامل كأنه مضروب في صفر، لذا يُنشأ الحقل بقيمة 0.
Qهل يتعامل $mul مع الأعداد العائمة؟
Aنعم؛ الدقة تعتمد على نوع BSON.
Qما الفرق بين $mul و $inc؟
A$inc يضيف أو يطرح؛ بينما يضرب $mul أو يقسم.