التابع Enumerable.flat_map في روبي

من موسوعة حسوب

يعيد التابع flat_map مصفوفة جديدة تحوي النتائج المجمَّعة الناتجة عن تنفيذ الكتلة المعطاة مع كل عنصر من عناصر الكائن القابل للتعداد الذي استدعي معه.

إن لم تُعطَ أية كتلة، فسيعيد التابع كائنًا من النوع Enumerator.

البنية العامة

flat_map { |obj| block }  array
flat_map  an_enumerator

القيمة المعادة

تعاد مصفوفة جديدة تحوي النتائج المجمَّعة الناتجة عن تنفيذ الكتلة block مع كل عنصر من عناصر الكائن القابل للتعداد المعطى.

أمثلة

مثال على استعمال التابع flat_map:

[1, 2, 3, 4].flat_map { |e| [e, -e] } #=> [1, -1, 2, -2, 3, -3, 4, -4]
[[1, 2], [3, 4]].flat_map { |e| e + [100] } #=> [1, 2, 100, 3, 4, 100]

انظر أيضًا

  • التابع collect_concat: يعيد مصفوفة جديدة مع نتائج متصلة لتنفيذ الكتلة المعطاة مع كل عنصر من عناصر المُعدِّد الذي استدعي معه.
  • التابع group_by: يجمِّع عناصر الكائن القابل للتعداد الذي استدعي معه في مجموعات بحسب النتيجة المقابلة لكل عنصر التي تعيدها الكتلة المعطاة بعد تمريره إليها.

مصادر