$trim (قصّ الطرفين)
آخر تحديث: 2026-10-09
$trim (قصّ الطرفين)
يزيل $trim الفراغات (المسافات، الجداول، الأسطر الجديدة) من طرفي سلسلة نصية، أو يقصّ مجموعة أحرف مخصصة تعطى بـ chars. يناسب تنظيف مدخلات المستخدم، أسطر السجلات، أو حقول CSV. بدون chars تُزال الفراغات فقط؛ ومع chars يُقصّ كل حرف طرفي ضمن المجموعة. المدخل الفارغ أو المفقود يُرجع null. استخدم $ltrim أو $rtrim لطرف واحد فقط.
| الفئة | النص |
|---|---|
| إصدار MongoDB | 1.0+ |
| لغة المثال | mongosh (الطرفية) |
📝 الصيغة
{ $trim: { input: <string-expression>, chars: <charset> } }⚙️ المعلمات
| input | مطلوب؛ النص المراد معالجته. |
|---|---|
| chars | مجموعة أحرف مخصَّصة اختيارية للإزالة؛ الافتراضي هو المسافات البيضاء. |
القيمة المرجعة：النص بعد إزالة الفراغات؛ null إذا كان الإدخال null.
▶ مثال
نفّذ الأوامر التالية في mongosh المحلي لديك (يتطلب تشغيل mongod):
// $trim: تنظيف الأسماء التي أدخلها المستخدمون
db.users.aggregate([
{ $project: { name: { $trim: { input: '$name' } } } }
])المخرجات：
{ "_id": 1, "name": "Alice" }
{ "_id": 2, "name": "Bob" }📌 ملاحظات
- الفراغات الافتراضية تشمل المسافات والجداول وعلامات الرجوع والأسطر الجديدة
- إعطاء chars يعطّل قص الفراغات الافتراضي — أدرجهما معًا عند الحاجة
- لطرف واحد فقط، استخدم $ltrim أو $rtrim
🏷️ وسوم ذات صلة
💡 حالات ذات صلة
مزيد من الحالات العملية قريبًا.
📚 دروس ذات صلة
❓ الأسئلة الشائعة
Qماذا يقصّ افتراضيًا؟
Aالفراغات: المسافات والجداول والأسطر الجديدة وعلامات الرجوع.
Qهل يمكنني تخصيص ما يُقصّ؟
Aنعم — مرّر مجموعة أحرف عبر chars.
Qما الفرق عن $ltrim؟
A$ltrim يقصّ الطرف الأيسر فقط؛ و $trim يقصّ الطرفين.
