عرض مصدر Ruby/Enumerable/each entry

<noinclude>{{DISPLAYTITLE: التابع <code>Enumerable.each_entry</code> في روبي}}</noinclude>
يستدعي التابع <code>each_entry</code> الكتلة المعطاة مرةً واحدةً على كل عنصر من عناصر [[Ruby/Enumerable|الكائن القابل للتعداد]] الذي استدعي معه.

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

==البنية العامة==
<syntaxhighlight lang="ruby">each_entry { |obj| block } → enum
each_entry → an_enumerator</syntaxhighlight>
==القيمة المعادة==
يعاد كائن من النوع <code>[[Ruby/Enumerator|Enumerator]]</code> يحوي نتائج استدعاء الكتلة مرةً واحدةً على كل عنصر من عناصر [[Ruby/Enumerable|الكائن القابل للتعداد]] المعطى، أو يعاد كائنٌ جديد من النوع <code>[[Ruby/Enumerator|Enumerator]]</code> إن لم تُعطَ الكتلة.
==أمثلة==
مثال على استعمال التابع <code>each_entry</code>:<syntaxhighlight lang="ruby">
class Foo
  include Enumerable
  def each
    yield 1
    yield 1, 2
    yield
  end
end
Foo.new.each_entry{ |o| p o }
</syntaxhighlight>ناتج تنفيذ هذا المثال هو:<syntaxhighlight lang="text">
1
[1, 2]
nil
</syntaxhighlight>

==انظر أيضًا==
*التابع <code>[[Ruby/Enumerable/each cons|each_cons]]</code>: يُكرِّر الكتلة المعطاة على كل مصفوفة من <code>n</code> عنصر متتالي من عناصر [[Ruby/Enumerable|الكائن القابل للتعداد]] الذي استدعي معه.
*التابع <code>[[Ruby/Enumerable/each slice|each_slice]]</code>: يكرِّر الكتلة المعطاة على كل قطعة مكونة من <code>n</code> عنصر من عناصر [[Ruby/Enumerable|الكائن القابل للتعداد]] الذي استدعي معه.
*التابع <code>[[Ruby/Enumerable/each with index|each_with_index]]</code>: يستدعي الكتلة المعطاة مع وسيطين هما: العنصر نفسه وفهرسه لكل عنصر من عناصر [[Ruby/Enumerable|الكائن القابل للتعداد]] الذي استدعي معه. 
*التابع <code>[[Ruby/Enumerable/each with object|each_with_object]]</code>: يكرِّر الكتلة المعطاة على كل عنصر من عناصر [[Ruby/Enumerable|الكائن القابل للتعداد]] الذي استدعي معه مع كائن اعتباطي (الكائن المُمرَّر إليه) ثم يعيد هذا الكائن.
==مصادر==
*[http://ruby-doc.org/core-2.5.1/Enumerable.html#method-i-each_entry قسم التابع each_entry في الصنف Enumerable في توثيق روبي الرسمي.]
[[تصنيف: Ruby]]
[[تصنيف: Ruby Method]]
[[تصنيف: Ruby Enumerable]]