عرض مصدر Ruby/Hash/each pair

<noinclude>{{DISPLAYTITLE:التابع <code>Hash.each_pair</code> في روبي}}</noinclude>
[[تصنيف: Ruby]]
[[تصنيف: Ruby Method]]
[[تصنيف: Ruby Hash]]
يستدعي التابع <code>each_pair</code> الكتلة المعطاة مرةً واحدةً لكل مفتاح من مفاتيح أزواج الكائن <code>[[Ruby/Hash|Hash]]</code> الذي استدعي معه بعد تمرير مفتاح وقيمة الأزواج إليها.
==البنية العامة==
<syntaxhighlight lang="ruby">each {| key, value | block } → hsh
each_pair {| key, value | block } → hsh
each → an_enumerator
each_pair → an_enumerator</syntaxhighlight>
==القيمة المعادة==
يعاد ناتج تنفيذ الكتلة <code>block</code> على كل زوج من أزواج الكائن <code>[[Ruby/Hash|Hash]]</code> المعطى بعد تمرير مفتاح وقيمة الأزواج إليها. إذا لم تُعطَ كتلة، يُعاد كائن من النوع <code>[[Ruby/Enumerator|enumerator]]</code> بدلًا من ذلك. 

== أمثلة ==
مثال على استعمال التابع <code>each_pair</code>:<syntaxhighlight lang="ruby">
h = { "a" => 100, "b" => 200 }
h.each {|key, value| puts "#{key} is #{value}" }
</syntaxhighlight>يُنتِج ما يلي:<syntaxhighlight lang="text">
a is 100
b is 200
</syntaxhighlight>
==انظر أيضا==
* التابع <code>[[Ruby/Hash/each|each]]</code>: يستدعي الكتلة المعطاة مرةً واحدةً لكل مفتاح من مفاتيح أزواج الكائن <code>[[Ruby/Hash|Hash]]</code> الذي استدعي معه بعد تمرير مفتاح وقيمة الأزواج إليها.
* التابع <code>[[Ruby/Hash/each value|each_value]]</code>: يستدعي الكتلة المعطاة مرةً واحدةً لكل مفتاح من مفاتيح أزواج الكائن <code>[[Ruby/Hash|Hash]]</code> الذي استدعي معه بعد تمرير قيمة كل زوج إليها.
* التابع <code>[[Ruby/Hash/each key|each_key]]</code>: يستدعي الكتلة المعطاة مرةً واحدةً لكل مفتاح من مفاتيح أزواج الكائن <code>[[Ruby/Hash|Hash]]</code> الذي استدعي معه بعد تمرير مفتاح كل زوج إليها.

==مصادر==
*[http://ruby-doc.org/core-2.5.1/Hash.html#method-i-each_pair قسم التابع each_pair في الصنف Hash في توثيق روبي الرسمي.]