$asin (قوس الجيب)
آخر تحديث: 2026-10-09
$asin (قوس الجيب)
يُرجع $asin قوس الجيب لعدد، مع التعبير عن النتيجة بالراديان. يجب أن يقع الإدخال بين -1 و 1. يُستخدم لاستعادة زاوية من قيمة جيب أو في تحويلات الإحداثيات. الوسيطة الفارغة أو المفقودة تُنتج null؛ والإدخال خارج النطاق [-1, 1] يرمي خطأً لعدم وجود زاوية حقيقية له. حوّل النتيجة من الراديان إلى درجات بـ $radiansToDegrees. $asin هو معكوس $sin: $sin($asin(x)) يساوي x.
| الفئة | الرياضيات |
|---|---|
| إصدار MongoDB | 1.0+ |
| لغة المثال | mongosh (الطرفية) |
📝 الصيغة
{ $asin: <numeric-expression> }
⚙️ المعلمات
| قيمة رقمية | تعبير رقمي بين -1 و1. |
|---|
القيمة المرجعة:قوس الجيب بالراديان؛ null عندما يكون null أو مفقودًا، وخطأ خارج النطاق [-1, 1]
▶ مثال
نفّذ الأوامر التالية في mongosh المحلي لديك (يتطلب تشغيل mongod):
// $asin: استعادة زاوية (بالراديان) من قيمة جيب
db.trig.aggregate([
{ $project: {
angleRad: { $asin: '$sinValue' }
} }
])
المخرجات:
{ '_id': 1, 'angleRad': 1.5707963267948966 }
{ '_id': 2, 'angleRad': 0.5235987755982989 }
📌 ملاحظات
- يجب أن يقع الإدخال بين -1 و 1؛ خارجه يرمي خطأً
- النتيجة بالراديان؛ حوّل بـ $radiansToDegrees
- إنه معكوس $sin
🏷️ وسوم ذات صلة
💡 حالات ذات صلة
مزيد من الحالات العملية قريبًا.
📚 دروس ذات صلة
❓ الأسئلة الشائعة
Qما نطاق إدخال $asin؟
Aيجب أن يكون بين -1 و 1؛ القيم الخارجة ترمي خطأً.
Qهل يُرجع $asin بالراديان أم بالدرجات؟
Aبالراديان؛ استخدم $radiansToDegrees للدرجات.
Qما قيمة $asin(1)؟
Aإنها π/2، أي قياس 90 درجة بالراديان، ويساوي تقريبًا 1.5708.