$pow (القوة)
آخر تحديث: 2026-10-09
$pow (القوة)
يرفع $pow عددًا إلى قوة. يأخذ وسيطتين — الأساس والأس — ويُرجع الأساس مرفوعًا إلى الأس. يُستخدم في حسابات المساحة والحجم والفائدة المركبة والقياس، مثل تربيع نصف القطر لمساحة الدائرة أو إزاحة القيم بقوى العشرة. الأس 0 يُنتج 1، وصفر مرفوعًا لقوة صفر يُرجع 1 في MongoDB. انتبه إلى أن الأساس السالب مع أس غير صحيح يُرجع null، لأن النتيجة ليست عددًا حقيقيًا. وأي وسيطة فارغة أو مفقودة تُنتج null.
| الفئة | الرياضيات |
|---|---|
| إصدار MongoDB | 1.0+ |
| لغة المثال | mongosh (الطرفية) |
📝 الصيغة
{ $pow: [ <base>, <exponent> ] }⚙️ المعلمات
| الأساس | قيمة رقمية أو تعبير يُحلّ إلى قيمة رقمية. |
|---|---|
| الأس | تعبير الأس؛ يجب أن يكون عددًا صحيحًا عندما يكون الأساس سالبًا. |
القيمة المرجعة：الأساس مرفوعًا إلى الأس؛ null إذا كان الأساس سالبًا والأس غير صحيح، أو كانت المعاملات null ومفقودة
▶ مثال
نفّذ الأوامر التالية في mongosh المحلي لديك (يتطلب تشغيل mongod):
// $pow: مساحة الدائرة من نصف القطر المربع (باي 3.14)
db.shapes.aggregate([
{ $project: {
area: { $multiply: [3.14, { $pow: ['$radius', 2] }] }
} }
])المخرجات：
{ '_id': 1, 'area': 28.26 }
{ '_id': 2, 'area': 12.56 }📌 ملاحظات
- صفر مرفوعًا لقوة صفر يُرجع 1
- الأساس السالب مع أس غير صحيح (مثل -8 مرفوعًا لـ 1/3) يُرجع null
- يمكنك أخذ الجذر التربيعي بأس 0.5، لكن $sqrt أوضح
🏷️ وسوم ذات صلة
💡 حالات ذات صلة
مزيد من الحالات العملية قريبًا.
📚 دروس ذات صلة
❓ الأسئلة الشائعة
Qكيف أخذ الجذر التربيعي باستخدام $pow؟
Aمرّر 0.5 كأس، لذا $pow: [9, 0.5] يعطي 3؛ أو استخدم $sqrt المخصص.
Qهل يدعم $pow الأساسات السالبة؟
Aمع الأساس السالب يجب أن يكون الأس عددًا صحيحًا؛ وإلا فالناتج ليس عددًا حقيقيًا ويُرجِع null.
Qماذا يُرجع $pow لأس يساوي صفرًا؟
Aأي أساس مرفوعًا لقوة صفر يساوي 1، وصفر مرفوعًا لقوة صفر يساوي 1 أيضًا.
