الفرق بين المراجعتين لصفحة: «Ruby/String/insert»
جميل-بيلوني (نقاش | مساهمات) إنشاء الصفحة. هذه الصفحة من مساهمات "كريم حبال". |
جميل-بيلوني (نقاش | مساهمات) إضافة المحتوى |
||
| سطر 3: | سطر 3: | ||
[[تصنيف: Ruby Method]] | [[تصنيف: Ruby Method]] | ||
[[تصنيف: Ruby String]] | [[تصنيف: Ruby String]] | ||
يُدرِج التابع <code>insert</code> السلسلة النصية المُمرَّرة إليه في موضع مُحدد، معدلًا السلسلة النصية التي استدعي معها. في حال تمرير فهرس سالب، فسيبدأ العد من نهاية السلسلة، وتُدرَج السلسلة النصية المعطاة بعد المحرف الذي يلي المحرف ذي الفهرس المُحدد. | |||
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="ruby">insert(index, other_str) → str</syntaxhighlight> | <syntaxhighlight lang="ruby">insert(index, other_str) → str</syntaxhighlight> | ||
== المعاملات == | |||
=== <code>index</code> === | |||
فهرس المحرف الذي ستُدرج قبله السلسلة <code>other_str</code>، أو بعده إذا كان هذا الفهرس سالبًا. | |||
=== <code>other_str</code> === | |||
السلسلة المُراد إدراجها في السلسلة النصية المُعطاة. | |||
==القيمة المعادة== | ==القيمة المعادة== | ||
تُعاد السلسلة النصية المعطاة بعد إدراج السلسلة <code>other_str</code> فيها في الموضع <code>index</code>. | |||
==أمثلة== | ==أمثلة== | ||
| سطر 18: | سطر 26: | ||
"abcd".insert(-1, 'X') #=> "abcdX"</syntaxhighlight> | "abcd".insert(-1, 'X') #=> "abcdX"</syntaxhighlight> | ||
==انظر | ==انظر أيضًا== | ||
* التابع <code>[[Ruby/String/concat|concat]]</code>: يضيف كائنات محدَّدة إلى السلسلة النصية التي استدعيت معه. | |||
* التابع <code>[[Ruby/String/end with-3F|end_with?]]</code>: يتحقق إذا كانت السلسلة النصية منتهية بإحدى اللواحق المُحددة. | |||
==مصادر== | ==مصادر== | ||
*[http://ruby-doc.org/core-2.5.1/String.html#method-i-insert قسم التابع insert في الصنف String في توثيق روبي الرسمي.] | *[http://ruby-doc.org/core-2.5.1/String.html#method-i-insert قسم التابع insert في الصنف String في توثيق روبي الرسمي.] | ||
المراجعة الحالية بتاريخ 11:25، 12 ديسمبر 2018
يُدرِج التابع 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?: يتحقق إذا كانت السلسلة النصية منتهية بإحدى اللواحق المُحددة.