التابع String.insert في روبي

من موسوعة حسوب
< Ruby‏ | String
اذهب إلى التنقل اذهب إلى البحث

يُدرِج التابع insert السلسلة النصية المُمرَّرة إليه في موضع مُحدد، معدلًا السلسلة النصية التي استدعي معها. في حال تمرير فهرس سالب، فسيبدأ العد من نهاية السلسلة، وتُدرَج السلسلة النصية المعطاة بعد المحرف الذي يلي المحرف ذي الفهرس المُحدد.

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

insert(index, other_str)  str

المعاملات

index

فهرس المحرف الذي ستُدرج قبله السلسلة other_str، أو بعده إذا كان هذا الفهرس سالبًا.

other_str

السلسلة المُراد إدراجها في السلسلة النصية المُعطاة.

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

تُعاد السلسلة النصية المعطاة بعد إدراج السلسلة other_str فيها في الموضع index.

أمثلة

مثال على استعمال التابع insert:

"abcd".insert(0, 'X')    #=> "Xabcd"
"abcd".insert(3, 'X')    #=> "abcXd"
"abcd".insert(4, 'X')    #=> "abcdX"
"abcd".insert(-3, 'X')   #=> "abXcd"
"abcd".insert(-1, 'X')   #=> "abcdX"

انظر أيضًا

  • التابع concat: يضيف كائنات محدَّدة إلى السلسلة النصية التي استدعيت معه.
  • التابع end_with?‎: يتحقق إذا كانت السلسلة النصية منتهية بإحدى اللواحق المُحددة.

مصادر