الفرق بين المراجعتين ل"Ruby/String/insert"

من موسوعة حسوب
< Ruby‏ | String
اذهب إلى التنقل اذهب إلى البحث
(إنشاء الصفحة. هذه الصفحة من مساهمات "كريم حبال".)
 
(إضافة المحتوى)
 
سطر 3: سطر 3:
 
[[تصنيف: Ruby Method]]
 
[[تصنيف: Ruby Method]]
 
[[تصنيف: Ruby String]]
 
[[تصنيف: Ruby String]]
يعيد التابع <code>insert</code> ب
+
يُدرِج التابع <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?‎: يتحقق إذا كانت السلسلة النصية منتهية بإحدى اللواحق المُحددة.

مصادر