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