$ln (اللوغاريتم الطبيعي)

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

$ln (اللوغاريتم الطبيعي)

يُرجع $ln اللوغاريتم الطبيعي (الأساس e) لعدد. يُستخدم في حسابات معدلات النمو وتمهيد البيانات وتحويلات المقياس اللوغاريتمي، مثل أخذ اللوغاريتم الطبيعي للأسعار قبل تحليل الانحدار. الوسيطة الفارغة أو المفقودة تُنتج null؛ ويجب أن يكون الإدخال موجبًا — فالقيم الصفرية أو السالبة تُرجع null. قيمة e تساوي تقريبًا 2.71828. للأساسات الأخرى استخدم $log مع أساس صريح، أو $log10 و $log2 المخصصين. $ln هو معكوس $exp.

الفئةالرياضيات
إصدار MongoDB1.0+
لغة المثالmongosh (الطرفية)

📝 الصيغة

{ $ln: <numeric-expression> }

⚙️ المعلمات

قيمة رقميةقيمة رقمية أو تعبير يُحلّ إلى قيمة رقمية؛ يجب أن يكون أكبر من 0.

القيمة المرجعة:اللوغاريتم الطبيعي للإدخال؛ null إذا كان الإدخال غير موجب أو null أو مفقودًا

▶ مثال

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

// $ln: أخذ اللوغاريتم الطبيعي للمبالغ
db.sales.aggregate([
  { $project: {
      logAmount: { $ln: '$amount' }
  } }
])

المخرجات:

{ '_id': 1, 'logAmount': 4.605170185988092 }
{ '_id': 2, 'logAmount': 2.995732273553991 }

📌 ملاحظات

مزيد من الحالات العملية قريبًا.

📚 دروس ذات صلة

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

Qما الفرق بين $ln و $log؟
A$ln يستخدم أساسًا ثابتًا هو e؛ $log يأخذ الأساس كوسيطته الثانية.
Qماذا يُرجع $ln للإدخال الصفري أو السالب؟
Aيُرجع null؛ اللوغاريتمات معرّفة للأعداد الموجبة فقط.
Qكيف أستعيد القيمة الأصلية من اللوغاريتم الطبيعي؟
Aطبّق $exp على النتيجة لعكس اللوغاريتم.
Web-Tutorial.com

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

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

100%