عرض مصدر Ruby/Enumerable/group by

<noinclude>{{DISPLAYTITLE: التابع <code>Enumerable.group_by</code> في روبي}}</noinclude>
يجمِّع التابع <code>group_by</code> عناصر الكائن القابل للتعداد الذي استدعي معه في مجموعات بحسب النتيجة المقابلة لكل عنصر التي تعيدها الكتلة المعطاة بعد تمريره إليها.

إن لم تُعطَ أية كتلة، فسيعيد التابع كائنًا من النوع <code>[[Ruby/Enumerator|Enumerator]]</code>.

==البنية العامة==
<syntaxhighlight lang="ruby">group_by { |obj| block } → a_hash
group_by → an_enumerator</syntaxhighlight>
==القيمة المعادة==
يعاد كائن من النوع <code>[[Ruby/Hash|Hash]]</code> تكون قيم المفاتيح فيه هي قيمة العنصر المقابلة التي تعيدها الكتلة <code>block</code> والقيم فيه هي مصفوفات تحوي العناصر المقابلة لكل مفتاح أعادته الكتلة من [[Ruby/Enumerable|الكائن القابل للتعداد]] المعطى. إن لم تُعطَ أية كتلة، فسيعاد كائن من النوع <code>[[Ruby/Enumerator|Enumerator]]</code>.
==أمثلة==
مثال على استعمال التابع <code>group_by</code>:<syntaxhighlight lang="ruby">
(1..6).group_by { |i| i%3 }   #=> {0=>[3, 6], 1=>[1, 4], 2=>[2, 5]}
</syntaxhighlight>
==انظر أيضًا==
*التابع <code>[[Ruby/Enumerable/chunk while|chunk_while]]</code>: ينشئ [[Ruby/Enumerator|مُعدِّدًا]] لكل جزء من العناصر المجمَّعة سويةً. تُعرَّف بداية الأجزاء (chunks) عبر الكتلة المعطاة.

*التابع <code>[[Ruby/Enumerable/flat map|flat_map]]</code>: يعيد مصفوفة جديدة تحوي النتائج المجمَّعة الناتجة عن تنفيذ الكتلة المعطاة مع كل عنصر من عناصر [[Ruby/Enumerable|الكائن القابل للتعداد]] الذي استدعي معه.
==مصادر==
*[http://ruby-doc.org/core-2.5.1/Enumerable.html#method-i-group_by قسم التابع group_by في الصنف Enumerable في توثيق روبي الرسمي.]
[[تصنيف: Ruby]]
[[تصنيف: Ruby Method]]
[[تصنيف: Ruby Enumerable]]