$sign (الإشارة)

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

$sign (الإشارة)

يُرجع $sign إشارة عدد: 1 للأعداد الموجبة و -1 للأعداد السالبة و 0 للصفر. يُستخدم لعد الفئات وفحوصات اتجاه الصعود/الهبوط وتجميع البيانات، مثل تحويل تغيّر السعر إلى صعود أو هبوط أو ثبات. الوسيطة الفارغة أو المفقودة تُنتج null، وإدخال NaN يُرجع NaN. وبدمجه مع $abs يعطي اتجاه القيمة ومقدارها معًا، وهو أكثر إيجازًا من سلاسل المقارنات في التعبير الشرطي، ومفيد لعدّ المجموعات لاحقًا.

📝 الصيغة

{ $sign: <numeric-expression> }

⚙️ المعلمات

القيمة المرجعة：‏1 أو -1 أو 0؛ NaN إذا كان الإدخال NaN، وnull عندما يكون null أو مفقودًا

▶ مثال

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

// $sign: اتجاه تغيّر السعر
db.stocks.aggregate([
  { $project: {
      trend: { $sign: '$change' }
  } }
])

المخرجات：

{ '_id': 1, 'trend': 1 }
{ '_id': 2, 'trend': -1 }

📌 ملاحظات

• الصفر يُرجع 0، بما في ذلك الصفران الموقّعان
• إدخال NaN يُرجع NaN
• اجمعه مع $abs للحصول على الاتجاه والمقدار معًا

🏷️ وسوم ذات صلة

💡 حالات ذات صلة

📚 دروس ذات صلة

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

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

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

من نحن