التابع String.squeeze! في روبي
يستبدل التابع squeeze! المحارف المكررة على التوالي فى السلسلة النصية بمحرف واحد لكل منها. يمكن تحديد المحارف المراد إزالة تكرارها دون غيرها عبر تمريرها إلى التابع.
البنية العامة
squeeze!([other_str]*) → str or nil
المعاملات
other_str
تحدِّد السلسلة other_str مجموعة المحارف المُراد إزالة تكرارها من نسخة السلسلة النصية المُعطاة. عند استعمال الرمز ^ في بداية السلسلة other_str، فإن التابع يشمل جميع المحارف عدا محارف تلك السلسلة. الصيغة c1-c2 تعني جميع المحارف الواقعة في المجال بين c1 و c2. يُستعمل الخط المائل العكسي \ لتهريب الرمزين ^ و -، ولا يتم حسابه إلا إذا وقع في نهاية مجال، أو في نهاية السلسلة other_str.
القيمة المعادة
تُعاد السلسلة النصية المعطاة نفسها مع استبدال المحارف المكررة على التوالي بمحرف واحد لكل منها؛ يمكن استعمال المعامل other_str لتحديد مجموعة المحارف المُراد إزالة تكرارها دون غيرها.
أمثلة
أمثلة على استعمال التابع !squeeze:
a=“yellow moon”
a.squeeze! #=> "yelow mon"
a #=> "yelow mon"
انظر أيضًا
- التابع
rstrip!: يحذف المسافة البيضاء من نهاية السلسلة النصية التي استدعي معها.
- التابع
slice!: يقتطع محرفًا ذا فهرس محدد، أو جزءًا محددًا ببداية وطول، أو مجالًا محددًا ببداية ونهاية من السلسلة النصية التي استدعيت معه.
- التابع
squeeze: يعيد نسخة عن السلسلة النصية التي استدعي معها مع استبدال المحارف المكررة على التوالي بمحرف واحد لكل منها.