التابع String.tr! في روبي
يستبدل التابع !tr مجموعة محارف محدَّدة في السلسلة النصية المُعطاة بمحارف مقابلة لها.
البنية العامة
tr!(from_str, to_str) → str or nil
يستبدل التابع !tr مجموعة حروف السلسلة from_str في السلسلة النصية المُعطاة بالمحارف المقابلة لها في السلسلة to_str. إذا كانت السلسلة to_str أقصر من السلسلة from_str، فسيكرر الحرف الأخير فيها حتى تصبحان متساويتين من أجل الحفاظ على التنسيق.
يمكن أن تحتوي كلا السلسلتين from_str و to_str على الصيغة c1-c2، والتي تُستعمَل للإشارة إلى مجال محدد من الحروف.
يشير الرمز ^ فى بداية السلسلة from_str إلى جميع اشتمال جميع المحارف باستثناء تلك المحددة.
يُستعمل الخط المائل العكسي \ لتهريب الرمزين ^ و -، ولا يتم حسابه إلا إذا وقع في نهاية مجال، أو فى نهاية كل من السلسلتين from_str و to_str.
المعاملات
from_str
سلسلة نصية تحدد مجموعة المحارف الموجودة في السلسلة النصية المُعطاة والمُراد استبدالها بالمحارف to_str المقابلة.
to_str
سلسلة نصية تحوي المحارف المقابلة التي ستحل مكان المحارف from_str في السلسلة النصية المُعطاة.
القيمة المعادة
تُعاد السلسلة النصية المُعطاة بعد استبدال مجموعة محارف السلسلة from_str بالمحارف المقابلة لها في السلسلة to_str، أو تُعاد القيمة nil فى حال عدم إجراء أي تعديل.
أمثلة
أمثلة على استعمال التابع !tr:
a="hello"
a.tr('el', 'ip') #=> "hippo"
a #=> "hippo"
انظر أيضًا
- التابع
partition: يبحث عن تطابق نص أو نمط محدد ضمن السلسلة النصية التي استدعي معها.
- التابع
tr: يعيد نسخة عن السلسلة النصية المُعطاة مع استبدال مجموعة محارف محدَّدة فيها بالمحارف المقابلة المعطاة. - التابع
tr_s!: يشبه التابعtr_sباستثناء أنَّه يجري عملية الاستبدال على السلسلة النصية بدلًا من نسخة عنها.