$toLower (تحويل إلى أحرف صغيرة)
آخر تحديث: 2026-10-09
$toLower (تحويل إلى أحرف صغيرة)
يحوّل $toLower سلسلة نصية إلى أحرف صغيرة — عامل تطبيع أساسي. يُستخدم لتوحيد صيغ التخزين، بناء مفاتيح استعلام غير حساسة لحالة الأحرف (مع الفهارس)، أو تنظيف مدخلات المستخدم. يقبل السلاسل النصية فقط؛ والأنواع الأخرى تُسبب خطأً، لذا حوّلها بـ $toString أولًا. وهو عكس $toUpper. الأحرف التي لا تمتلك حالة (مثل الصينية) تمر دون تغيير.
| الفئة | النص |
|---|---|
| إصدار MongoDB | 1.0+ |
| لغة المثال | mongosh (الطرفية) |
📝 الصيغة
{ $toLower: <string-expression> }
⚙️ المعلمات
| سلسلة نصية | مطلوب؛ تعبير النص المراد تحويله إلى أحرف صغيرة. |
|---|
القيمة المرجعة:النص بأحرف صغيرة.
▶ مثال
نفّذ الأوامر التالية في mongosh المحلي لديك (يتطلب تشغيل mongod):
// $toLower: توحيد رسائل البريد إلى أحرف صغيرة
db.users.aggregate([
{ $project: { emailLower: { $toLower: '$email' } } }
])
المخرجات:
{ "_id": 1, "emailLower": "alice@example.com" }
{ "_id": 2, "emailLower": "bob@example.com" }
📌 ملاحظات
- السلاسل النصية فقط — حوّل الأرقام والتواريخ أولًا
- عكس $toUpper
- الأحرف التي لا تمتلك حالة، مثل الصينية، تمر دون تغيير
🏷️ وسوم ذات صلة
💡 حالات ذات صلة
مزيد من الحالات العملية قريبًا.
📚 دروس ذات صلة
❓ الأسئلة الشائعة
Qهل يؤثر في الصينية؟
Aالصينية بلا حالة — تُعاد الأحرف دون تغيير.
Qهل تسرّع الأحرف الصغيرة الاستعلامات؟
Aتخزين الأحرف الصغيرة بشكل موحد يتيح للفهارس خدمة المطابقات الدقيقة بكفاءة أعلى.
Qماذا يحدث عند استخدامه مع $toUpper؟
Aالتحويل ذهابًا وإيابًا يستعيد الأصل — دون أثر إضافي.