التابع String.insert
في روبي
يُدرِج التابع 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?
: يتحقق إذا كانت السلسلة النصية منتهية بإحدى اللواحق المُحددة.