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