الفرق بين المراجعتين لصفحة: «Ruby/Array/!collect»
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: التابع <code>Array.collect!</code> في روبي}}</noinclude> تصنيف: Ruby تصنيف: Ruby Method تصنيف: Ruby...' |
لا ملخص تعديل |
||
سطر 3: | سطر 3: | ||
[[تصنيف: Ruby Method]] | [[تصنيف: Ruby Method]] | ||
[[تصنيف: Ruby Array]] | [[تصنيف: Ruby Array]] | ||
يستدعي التابع | يستدعي التابع<code>!collect</code> كتلة برمجية محددة مع كل عنصر من عناصر مصفوفة ثم يضع القيمة التي أعادتها تلك الكتلة مكان العنصر الذي استدعيت معه. | ||
إن لم يمرَّر أي شيء إلى هذا التابع، فسيعيد كائنا من النوع <code>Enumerator</code>. | إن لم يمرَّر أي شيء إلى هذا التابع، فسيعيد كائنا من النوع <code>Enumerator</code>. | ||
==البنية العامة== | ==البنية العامة== | ||
سطر 12: | سطر 13: | ||
تعاد المصفوفة نفسها المعطاة بعد تبديل القيمة الجديدة التي تعيدها الكتلة <code>block</code> عند تطبيقها على كل عنصر من عناصر تلك المصفوفة مكان القيمة القديمة لذلك العنصر، أو يعاد كائنٌ من النوع <code>Enumerator</code> إن لم تمرَّر الكتلة <code>block</code>. | تعاد المصفوفة نفسها المعطاة بعد تبديل القيمة الجديدة التي تعيدها الكتلة <code>block</code> عند تطبيقها على كل عنصر من عناصر تلك المصفوفة مكان القيمة القديمة لذلك العنصر، أو يعاد كائنٌ من النوع <code>Enumerator</code> إن لم تمرَّر الكتلة <code>block</code>. | ||
==أمثلة== | ==أمثلة== | ||
أمثلة على استخدام التابع | أمثلة على استخدام التابع <code>!collect</code>: | ||
<syntaxhighlight lang="ruby"> a = [ "a", "b", "c", "d" ] | <syntaxhighlight lang="ruby"> a = [ "a", "b", "c", "d" ] | ||
a.map! {|x| x + "!" } | a.map! {|x| x + "!" } | ||
سطر 21: | سطر 22: | ||
==انظر أيضًا== | ==انظر أيضًا== | ||
* التابع [[Ruby/Array/collect | <code>collect</code>]]: يستدعي كتلة برمجية محدَّدة مع كل عنصر من عناصر مصفوفة ثمَّ يعيد مصفوفة جديدة تحوي القيم التي تعيدها تلك الكتلة. | * التابع [[Ruby/Array/collect | <code>collect</code>]]: يستدعي كتلة برمجية محدَّدة مع كل عنصر من عناصر مصفوفة ثمَّ يعيد مصفوفة جديدة تحوي القيم التي تعيدها تلك الكتلة. | ||
* التابع | * التابع<code>[[Ruby/Array/!map|!map]]</code>: يستدعي كتلة برمجية محدَّدة مع كل عنصر من عناصر مصفوفة ثمَّ يضع القيمة التي أعادتها تلك الكتلة مكان العنصر الذي طُبِّقَت عليه. | ||
* التابع [[Ruby/Array/fill | <code>fill</code>]]: يضبط قيم عناصر محدَّدة أو جميع عناصر مصفوفة إلى القيمة الممرَّرة إليه، أو القيم التي تعيدها الكتلة البرمجية الممرَّرة إليه. | * التابع [[Ruby/Array/fill | <code>fill</code>]]: يضبط قيم عناصر محدَّدة أو جميع عناصر مصفوفة إلى القيمة الممرَّرة إليه، أو القيم التي تعيدها الكتلة البرمجية الممرَّرة إليه. | ||
* التابع [[Ruby/Array/push | <code>push</code>]]: يضيف جميع الكائنات المُمرّرة إليه إلى نهاية المصفوفة التي استُدعيت معه. | * التابع [[Ruby/Array/push | <code>push</code>]]: يضيف جميع الكائنات المُمرّرة إليه إلى نهاية المصفوفة التي استُدعيت معه. | ||
==مصادر== | ==مصادر== | ||
* قسم التابع !collect في الصنف Array في توثيق روبي الرسمي. | * [https://ruby-doc.org/core-2.5.1/Array.html#method-i-collect-21 قسم التابع !collect في الصنف Array في توثيق روبي الرسمي.] |
مراجعة 12:20، 5 سبتمبر 2018
يستدعي التابع!collect
كتلة برمجية محددة مع كل عنصر من عناصر مصفوفة ثم يضع القيمة التي أعادتها تلك الكتلة مكان العنصر الذي استدعيت معه.
إن لم يمرَّر أي شيء إلى هذا التابع، فسيعيد كائنا من النوع Enumerator
.
البنية العامة
collect! {|item| block } → ary
collect! → Enumerator
القيم المعادة
تعاد المصفوفة نفسها المعطاة بعد تبديل القيمة الجديدة التي تعيدها الكتلة block
عند تطبيقها على كل عنصر من عناصر تلك المصفوفة مكان القيمة القديمة لذلك العنصر، أو يعاد كائنٌ من النوع Enumerator
إن لم تمرَّر الكتلة block
.
أمثلة
أمثلة على استخدام التابع !collect
:
a = [ "a", "b", "c", "d" ]
a.map! {|x| x + "!" }
a #=> [ "a!", "b!", "c!", "d!" ]
a.collect!.with_index {|x, i| x[0...i] }
a #=> ["", "b", "c!", "d!"]
انظر أيضًا
- التابع
collect
: يستدعي كتلة برمجية محدَّدة مع كل عنصر من عناصر مصفوفة ثمَّ يعيد مصفوفة جديدة تحوي القيم التي تعيدها تلك الكتلة. - التابع
!map
: يستدعي كتلة برمجية محدَّدة مع كل عنصر من عناصر مصفوفة ثمَّ يضع القيمة التي أعادتها تلك الكتلة مكان العنصر الذي طُبِّقَت عليه. - التابع
fill
: يضبط قيم عناصر محدَّدة أو جميع عناصر مصفوفة إلى القيمة الممرَّرة إليه، أو القيم التي تعيدها الكتلة البرمجية الممرَّرة إليه. - التابع
push
: يضيف جميع الكائنات المُمرّرة إليه إلى نهاية المصفوفة التي استُدعيت معه.