عرض مصدر Ruby/Array/fill

<noinclude>{{DISPLAYTITLE: التابع <code>Array.fill</code> في روبي}}</noinclude>
[[تصنيف: Ruby]]
[[تصنيف: Ruby Method]]
[[تصنيف: Ruby Array]]
يضبط التابع <code>fill</code> قيم عناصر محدَّدة أو جميع عناصر مصفوفة إلى القيمة الممرَّرة إليه (الأشكال الثلاث الأولى للتابع في قسم «البنية العامة»)، أو القيم التي تعيدها الكتلة البرمجية الممرَّرة إليه (الأشكال الثلاث المتبقية).

==البنية العامة==
<syntaxhighlight lang="ruby"> fill(obj) → ary
fill(obj, start [, length]) → ary
fill(obj, range ) → ary
fill { |index| block } → ary
fill(start [, length] ) { |index| block } → ary
fill(range) { |index| block } → ary
 </syntaxhighlight>
==المعاملات==

=== <code>obj</code> ===
الكائن المراد أن يحل مكان عناصر محددة (باستعمال المعاملات <code>start</code> و  <code>length</code> و <code>rang</code>) في المصفوفة المعطاة.

=== <code>start</code> ===
عدد صحيح يمثل فهرس العنصر المراد استبدال قيمته أو بداية العناصر المراد استبدال قيمتها. إن كانت قيمة هذا المعامل سالبة، فسيحسب موضع العنصر بدءًا من نهاية المصفوفة.

إن أعطيت القيمة <code>nil</code> للوسيط <code>start</code>، فذلك يكافئ تمرير القيمة <code>0</code> لهذا الوسيط. وفي حال كانت قيمة الوسيط <code>start</code> سالبة، فسيُحسَب موضع كل عنصر يراد تبديل قيمته بدءًا من نهاية المصفوفة.

=== <code>length</code> ===
عدد صحيح يمثل طول العناصر المراد استبدال قيمتها. في حال إعطاء القيمة <code>nil</code> للوسيط <code>length</code>، فذلك يكافئ تمرير طول المصفوفة المعطاة.

=== <code>rang</code> ===
مجالٌ يحدد بداية ونهاية العناصر المراد استبدال قيمتها.
==القيم المعادة==
تعاد المصفوفة نفسها بعد تبديل قيمة الوسيط <code>obj</code> أو القيم التي تعيدها الكتلة <code>block</code> (التي يُمرَّر إليها قيمة فهرس العنصر المستهدف) مكان جميع عناصر المصفوفة المعطاة إن لم يمرَّر أي وسيط آخر، أو بدءًا من العنصر ذي الفهرس <code>start</code> وحتى العنصر ذي الفهرس  <code>length</code>، أو مكان العناصر الواقعة ضمن المجال <code>rang</code>.
==أمثلة==
أمثلة على استخدام التابع <code>fill</code>:
<syntaxhighlight lang="ruby"> a = [ "a", "b", "c", "d" ]
a.fill("x")              #=> ["x", "x", "x", "x"]
a.fill("z", 2, 2)        #=> ["x", "x", "z", "z"]
a.fill("y", 0..1)        #=> ["y", "y", "z", "z"]
a.fill { |i| i*i }       #=> [0, 1, 4, 9]
a.fill(-2) { |i| i*i*i } #=> [0, 1, 8, 27]
 </syntaxhighlight>
==انظر أيضًا==
* التابع<nowiki/>[[Ruby/Array/map | <code>map</code>]]: يستدعي كتلة برمجية محدَّدة مع كل عنصر من عناصر مصفوفة ثمَّ يضع الناتج الذي تعيده هذه الكتلة لكل عنصر في مصفوفة جديدة وتعيدها.
* التابع <code>[[Ruby/Array/!collect|!collect]]</code>: يستدعي كتلة برمجية محددة مع كل عنصر من عناصر مصفوفة ثم يضع القيمة التي أعادتها تلك الكتلة مكان العنصر الذي استدعيت معه.
* التابع<nowiki/>[[Ruby/Array/cycle | <code>cycle</code>]]: يستدعي كتلة برمجية محددة مع كل عنصر من عناصر المصفوفة عددًا محددًا من المرات أو عددًا لا نهائيًّا من المرات إن أعطيت القيمة <code>nil</code>.
==مصادر==
* [https://ruby-doc.org/core-2.5.1/Array.html#method-i-fill قسم التابع Array.fill في الصنف Array في توثيق روبي الرسمي.]