$indexOfCP (فهرس السلسلة الفرعية بنقاط الرموز)

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

$indexOfCP (فهرس السلسلة الفرعية بنقاط الرموز)

يُرجع $indexOfCP فهرس نقطة الرمز (الحرف) لأول ظهور لسلسلة فرعية، أو -1 عند عدم العثور. يعدّ بالأحرف، بما يطابق الإدراك البشري ويبقى آمنًا مع الصينية والرموز التعبيرية — الخيار المفضّل للعمل النصي. يحدّان start و end الاختياريان النافذة، أيضًا بنقاط الرموز. يدمج مع $substrCP و $strLenCP للتقطيع. أي وسيطة فارغة تُرجع null.

📝 الصيغة

{ $indexOfCP: [ <string-expression>, <substring>, <start>, <end> ] }

⚙️ المعلمات

القيمة المرجعة：فهرس نقطة الكود (يبدأ من الصفر)؛ -1 عند عدم العثور عليه؛ وnull إذا كان أي معامل null.

▶ مثال

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

// $indexOfCP: تحديد موقع @ في رسائل البريد
db.users.aggregate([
  { $project: { at: { $indexOfCP: [ '$email', '@' ] } } }
])

المخرجات：

{ "_id": 1, "at": 6 }
{ "_id": 2, "at": -1 }

📌 ملاحظات

• يبدأ من الصفر؛ الحرف الصيني والرمز التعبيري يعدّ كلٌّ منهما 1
• يُدمج عادةً مع $substrCP و $strLenCP للتقطيع
• start/end خارج طول السلسلة تُثبَّت عند الحدود — دون خطأ

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

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

📚 دروس ذات صلة

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

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

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

من نحن