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