عرض مصدر Ruby/Array/!map

<noinclude>{{DISPLAYTITLE: التابع <code>Array.map!‎</code> في روبي}}</noinclude>
[[تصنيف: Ruby]]
[[تصنيف: Ruby Method]]
[[تصنيف: Ruby Array]]
يستدعي التابع !<code>!map</code> كتلة برمجية محدَّدة مع كل عنصر من عناصر مصفوفة ثمَّ يضع القيمة التي أعادتها تلك الكتلة مكان العنصر الذي طُبِّقَت عليه.
إن لم يمرَّر أي شيء إلى هذا التابع، فسيعيد كائنًا من النوع <code>Enumerator</code>.
==البنية العامة==
<syntaxhighlight lang="ruby"> map! {|item| block } → ary
map! → Enumerator
 </syntaxhighlight>
==القيم المعادة==
تعاد المصفوفة نفسها المعطاة بعد تبديل القيمة الجديدة التي تعيدها الكتلة <code>block</code> عند تطبيقها على كل عنصر من عناصر تلك المصفوفة مكان القيمة القديمة لذلك العنصر، أو يعاد كائنٌ من النوع <code>Enumerator</code> إن لم تمرَّر الكتلة <code>block</code>.
==أمثلة==
مثالٌ على استخدام التابع !<code>!map</code>:
<syntaxhighlight lang="ruby"> a = [ "a", "b", "c", "d" ]
a.map! {|x| x + "!" }
a #=>  [ "a!", "b!", "c!", "d!" ]
 </syntaxhighlight>
==انظر أيضًا==
* التابع [[Ruby/Array/map | <code>map</code>]]: يستدعي كتلة برمجية محدَّدة مع كل عنصر من عناصر مصفوفة ثمَّ يضع الناتج الذي تعيده هذه الكتلة لكل عنصر في مصفوفة جديدة وتعيدها.
* التابع [[Ruby/Array/collect! | <code>collect!</code>]]!‎: يستدعي كتلة برمجية محددة مع كل عنصر من عناصر مصفوفة ثم يضع القيمة التي أعادتها تلك الكتلة مكان العنصر الذي استدعيت معه.
* التابع [[Ruby/Array/replace | <code>replace</code>]]: يبدِّل محتوى المصفوفة الممرَّرة إليه مكان محتوى المصفوفة المستدعاة معه مع تغيير طولها إن دعت الحاجة لذلك.
* التابع [[Ruby/Array/each | <code>each</code>]]: يستدعي كتلة برمجية محدَّدة مع كل عنصر من عناصر مصفوفة، إذ تمرَّر قيمة ذلك العنصر كوسيط إلى الكتلة ثمَّ يعيد المصفوفة نفسها المعطاة.
* التابع [[Ruby/Array/initialize_copy | <code>initialize_copy</code>]]: يبدل محتوى المصفوفة المُمرّرة إليه مكان محتوى المصفوفة التي استُدعيت معه مع تغيير طول المصفوفة عند الضرورة.
==مصادر==
* قسم التابع !Array.map في الصنف Array في توثيق روبي الرسمي.