$ceil (التقريب للأعلى)

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

$ceil (التقريب للأعلى)

يُرجع $ceil أصغر عدد صحيح أكبر من أو يساوي عددًا معينًا — أي التقريب للأعلى. يُستخدم في حسابات الصفحات أو تقدير السعات حيث يجب التقريب للأعلى، مثل 7.5 عناصر تتطلب 8 في المخزون. الوسيطة الفارغة أو المفقودة تُنتج null، ويمر الإدخال الصحيح دون تغيير. وهو عكس $floor ويختلف عن $trunc مع الأعداد السالبة: -1.2 يصبح -1 مع $ceil، و -1 مع $trunc، و -2 مع $floor.

📝 الصيغة

{ $ceil: <numeric-expression> }

⚙️ المعلمات

القيمة المرجعة：أصغر عدد صحيح أكبر من الإدخال أو مساوٍ له؛ null عندما يكون null أو مفقودًا

▶ مثال

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

// $ceil: تقريب الصناديق للأعلى مع 12 عنصرًا في كل صندوق
db.orders.aggregate([
  { $project: {
      boxes: { $ceil: { $divide: ['$quantity', 12] } }
  } }
])

المخرجات：

{ '_id': 1, 'boxes': 1 }
{ '_id': 2, 'boxes': 2 }

📌 ملاحظات

• مع الأعداد السالبة يسير في الاتجاه المعاكس لـ $floor: $ceil(-1.2) يساوي -1 بينما $floor(-1.2) يساوي -2
• الإدخال الصحيح يمر دون تغيير
• الوسائط الفارغة أو المفقودة تُنتج null

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

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

📚 دروس ذات صلة

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

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

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

من نحن