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