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

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

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

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

each_entry { |obj| block } → enum
each_entry → an_enumerator

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

يعاد كائن من النوع Enumerator يحوي نتائج استدعاء الكتلة مرةً واحدةً على كل عنصر من عناصر الكائن القابل للتعداد المعطى، أو يعاد كائنٌ جديد من النوع Enumerator إن لم تُعطَ الكتلة.

أمثلة

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

class Foo
  include Enumerable
  def each
    yield 1
    yield 1, 2
    yield
  end
end
Foo.new.each_entry{ |o| p o }

ناتج تنفيذ هذا المثال هو:

1
[1, 2]
nil

انظر أيضًا

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

مصادر

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