$mod (الباقي)

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

$mod (الباقي)

يطابق $mod المستندات التي يترك فيها قسمة قيمة الحقل على مقسوم باقيًا محددًا. فالعبارة `{ qty: { $mod: [4, 0] } }` تطابق الكميات القابلة للقسمة على 4. شائع لإنشاء المجموعات والتصفية الدورية. منذ MongoDB 5.1 يجب أن يكون المقسوم والباقي عددين صحيحين؛ والقيم العائمة ترمي خطأ.

📝 الصيغة

{ <field>: { $mod: [ <divisor>, <remainder> ] } }

⚙️ المعلمات

القيمة المرجعة：مؤشر المستندات المطابقة

▶ مثال

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

// $mod: الكميات القابلة للقسمة على 4
db.products.find({ qty: { $mod: [4, 0] } })

// الباقي 1: أول عنصر من كل مجموعة من 4
db.products.find({ qty: { $mod: [4, 1] } })

المخرجات：

// يُرجع الكميات التي باقيها 0 (قابلة للقسمة)؛ الاستعلام الثاني يُرجع باقيها 1

📌 ملاحظات

• المصفوفة ثابتة بالترتيب [divisor, remainder]؛ حافظ على الترتيب
• أعداد صحيحة فقط منذ 5.1؛ الأعداد العائمة ترمي خطأ، والسالبة تعتمد على دلالات الباقي
• لا يمكنه استخدام فهرس؛ للبيانات الكبيرة فضّل تعبير التجميع $mod

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

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

📚 دروس ذات صلة

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

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

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

من نحن