$abs (القيمة المطلقة)
آخر تحديث: 2026-10-09
$abs (القيمة المطلقة)
يُرجع $abs القيمة المطلقة لتعبير رقمي واحد. يُستخدم غالبًا لحساب المسافات أو الانحرافات أو الأخطاء، مثل مقدار بُعد القيمة الفعلية عن الهدف، أو إزاحة جغرافية. الوسيطة الفارغة أو المفقودة تُنتج null؛ وتبقى اللانهاية الموجبة كما هي، وتصبح الأرقام السالبة موجبة. وبدمجه مع $sign يعطي كلا من المقدار والإشارة لعدد ما. يدعم $abs الأعداد الصحيحة و double و Decimal.
| الفئة | الرياضيات |
|---|---|
| إصدار MongoDB | 1.0+ |
| لغة المثال | mongosh (الطرفية) |
📝 الصيغة
{ $abs: <numeric-expression> }
⚙️ المعلمات
| قيمة رقمية | قيمة رقمية أو تعبير يُحلّ إلى قيمة رقمية. |
|---|
القيمة المرجعة:القيمة المطلقة؛ null عندما يكون المعامل null أو مفقودًا
▶ مثال
نفّذ الأوامر التالية في mongosh المحلي لديك (يتطلب تشغيل mongod):
// $abs: حساب الفجوة بين الفعلي والهدف
db.sales.aggregate([
{ $project: {
gap: { $abs: { $subtract: ['$actual', '$target'] } }
} }
])
المخرجات:
{ '_id': 1, 'gap': 5 }
{ '_id': 2, 'gap': 3 }
📌 ملاحظات
- الوسائط الفارغة أو المفقودة تُنتج null
- اللانهاية السالبة تصبح لانهاية موجبة
- تختفي الإشارة بعد abs؛ اجمعها مع $sign عندما تكون الإشارة الأصلية مهمة
🏷️ وسوم ذات صلة
💡 حالات ذات صلة
مزيد من الحالات العملية قريبًا.
📚 دروس ذات صلة
❓ الأسئلة الشائعة
Qماذا يُرجع $abs لقيمة null؟
Aيُرجع null؛ لفّها بـ $ifNull عندما تحتاج قيمة افتراضية.
Qهل يمكن لـ $abs أخذ القيمة المطلقة للانهاية السالبة؟
Aنعم، النتيجة هي Infinity.
Qكيف أحصل على كل من الإشارة والقيمة المطلقة؟
Aاستخدم $sign للإشارة (1 أو -1 أو 0) و $abs للمقدار.