التابع String.delete!‎ في روبي

من موسوعة حسوب
< Ruby‏ | String

يحذف التابع delete!‎ محارف السلسلة النصية المُمرَّرة إليه من السلسلة النصية التي استدعي معها.

البنية العامة

delete!([other_str]+)  str or nil

المعاملات

other_str

السلسلة المُراد حذف حروفها من نسخة السلسلة النصية المُعطاة. في حال إضافة أكثر من سلسلة نصية، فإن التابع يعيد نسخة عن السلسلة المعطاة محذوفًا منها المحارف المتقاطعة لتلك السلاسل النصية المعطاة.

عند استعمال الرمز ^ في بداية السلسلة other_str، فإن التابع يعيد نسخة عن السلسلة المعطاة محذوفًا منها جميع المحارف عدا محارف السلسلة other_str تلك. الصيغة c1-c2 تعني جميع الحروف الواقعة في المجال بين c1 و c2.

يُستعمل الخط المائل العكسي \ لتهريب الرمزين ^ و -، ولا يُحذَف من نسخة السلسلة str إلا إذا وقع في نهاية مجال، أو في نهاية السلسلة other_str.

القيمة المعادة

تُعاد السلسلة النصية المُعطاة نفسها بعد حذف محارف السلسلة other_str منها. ستُعاد القيمة nil في حال عدم إجراء أي تعديل على السلسلة النصية.

انظر أيضًا

  • التابع delete: يعيد نسخة عن السلسلة النصية المُعطاة محذوفًا منها محارف السلسلة النصية المُمرَّرة إليه.
  • التابع delete_prefix!‎: يحذف سابقة محددة من السلسلة النصية المعطاة.
  • التابع delete_suffix!‎: يحذف لاحقة محددة من السلسلة النصية التي استدعي معها.

مصادر