عرض مصدر Ruby/Enumerable/each with index

<noinclude>{{DISPLAYTITLE: التابع <code>Enumerable.each_with_index</code> في روبي}}</noinclude>
يستدعي التابع <code>each_with_index</code> الكتلة المعطاة مع وسيطين هما: العنصر نفسه وفهرسه لكل عنصر من عناصر [[Ruby/Enumerable|الكائن القابل للتعداد]] الذي استدعي معه. إن مُرِّر أي شيء إلى التابع، فسيُمرَّر مباشرةً إلى <code>()each</code>.

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

==البنية العامة==
<syntaxhighlight lang="ruby">each_with_index(*args) { |obj, i| block } → enum
each_with_index(*args) → an_enumerator</syntaxhighlight>

== المعاملات ==

=== <code>args</code> ===
الوسائط المراد تمريرها إلى <code>()each</code>.

==القيمة المعادة==
يعاد [[Ruby/Enumerable|كائن قابل للتعداد]] يحوي نتائج تكرار الكتلة <code>block</code> على كل عنصر وفهرسه من عناصر [[Ruby/Enumerable|الكائن القابل للتعداد]] المعطى، أو يعاد كائنٌ من النوع <code>[[Ruby/Enumerator|Enumerator]]</code> إن لم تُعطَ الكتلة <code>block</code>.
==أمثلة==
مثال على استعمال التابع <code>each_with_index</code>:<syntaxhighlight lang="ruby">
hash = Hash.new
%w(cat dog wombat).each_with_index { |item, index|
  hash[item] = index
}
hash   #=> {"cat"=>0, "dog"=>1, "wombat"=>2}
</syntaxhighlight>
==انظر أيضًا==
*التابع <code>[[Ruby/Enumerable/each cons|each_cons]]</code>: يُكرِّر الكتلة المعطاة على كل مصفوفة من <code>n</code> عنصر متتالي من عناصر [[Ruby/Enumerable|الكائن القابل للتعداد]] الذي استدعي معه.
*التابع <code>[[Ruby/Enumerable/each entry|each_entry]]</code>: يستدعي الكتلة المعطاة مرةً واحدةً على كل عنصر من عناصر [[Ruby/Enumerable|الكائن القابل للتعداد]] الذي استدعي معه.
*التابع <code>[[Ruby/Enumerable/each slice|each_slice]]</code>: يكرِّر الكتلة المعطاة على كل قطعة مكونة من <code>n</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_with_index قسم التابع each_with_index في الصنف Enumerable في توثيق روبي الرسمي.]
[[تصنيف: Ruby]]
[[تصنيف: Ruby Method]]
[[تصنيف: Ruby Enumerable]]