التابع `Enumerable.each_cons` في روبي

يُكرِّر التابع each_cons الكتلة المعطاة على كل مصفوفة من n عنصر متتالي من عناصر الكائن القابل للتعداد الذي استدعي معه.

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

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

each_cons(n) { ... } → nil
each_cons(n) → an_enumerator

عدد العناصر المتعاقبة التي ستُكرَّر الكتلة عليها.

تعاد القيمة nil بعد تنفيذ العملية، أو يعاد كائنٌ من النوع Enumerator إن لم تُعطَ الكتلة.

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

(1..10).each_cons(3) { |a| p a }
# outputs below
[1, 2, 3]
[2, 3, 4]
[3, 4, 5]
[4, 5, 6]
[5, 6, 7]
[6, 7, 8]
[7, 8, 9]
[8, 9, 10]

التابع each_entry: يستدعي الكتلة المعطاة مرةً واحدةً على كل عنصر من عناصر الكائن القابل للتعداد الذي استدعي معه.
التابع each_slice: يكرِّر الكتلة المعطاة على كل قطعة مكونة من n عنصر من عناصر الكائن القابل للتعداد الذي استدعي معه.

التابع each_with_index: يستدعي الكتلة المعطاة مع وسيطين هما: العنصر نفسه وفهرسه لكل عنصر من عناصر الكائن القابل للتعداد الذي استدعي معه.
التابع each_with_object: يكرِّر الكتلة المعطاة على كل عنصر من عناصر الكائن القابل للتعداد الذي استدعي معه مع كائن اعتباطي (الكائن المُمرَّر إليه) ثم يعيد هذا الكائن.