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

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

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

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

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

المعاملات

n

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

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

تعاد القيمة 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: يكرِّر الكتلة المعطاة على كل عنصر من عناصر الكائن القابل للتعداد الذي استدعي معه مع كائن اعتباطي (الكائن المُمرَّر إليه) ثم يعيد هذا الكائن.

مصادر

• قسم التابع each_cons في الصنف Enumerable في توثيق روبي الرسمي.