عرض مصدر Ruby/Hash/merge

<noinclude>{{DISPLAYTITLE:التابع <code>Hash.merge</code> في روبي}}</noinclude>
[[تصنيف: Ruby]]
[[تصنيف: Ruby Method]]
[[تصنيف: Ruby Hash]]
يدمج التابع <code>merge</code> كائنين من النوع <code>[[Ruby/Hash|Hash]]</code> مع بعضهما بعضًا في كائن جديد من النوع <code>[[Ruby/Hash|Hash]]</code> ثم يعيده. إذا لم تُحدد أية كتلة، فستكون قيمة الأزواج ذات المفاتيح المُكررة هي نفسها وتؤخذ من الكائن المُمرَّر إلى التابع. أما إن أعطيت، فستُحدَد قيمة كل مفتاح مكرَّر عن طريق استدعاء الكتلة مع المفتاح وقيمته من الكائن المعطى وقيمته من الكائن المُمرَّر.
==البنية العامة==
<syntaxhighlight lang="ruby">merge(other_hash) → new_hash
merge(other_hash){|key, oldval, newval| block} → new_hash</syntaxhighlight>
==المعاملات==

=== <code>other_hash</code> ===
كائن جديد من النوع <code>[[Ruby/Hash|Hash]]</code> يراد دمج محتوياته مع الكائن <code>[[Ruby/Hash|Hash]]</code> المعطى.

==القيمة المعادة==
يعاد كائن جديد من النوع <code>[[Ruby/Hash|Hash]]</code> يحتوي على محتويات المعامل <code>other_hash</code> ومحتويات الكائن <code>[[Ruby/Hash|Hash]]</code> المعطى نفسه.  

== أمثلة ==
مثال على استعمال التابع <code>merge</code>:<syntaxhighlight lang="ruby">
h1 = { "a" => 100, "b" => 200 }
h2 = { "b" => 254, "c" => 300 }
h1.merge(h2)   #=> {"a"=>100, "b"=>254, "c"=>300}
h1.merge(h2){|key, oldval, newval| newval - oldval}
               #=> {"a"=>100, "b"=>54,  "c"=>300}
h1             #=> {"a"=>100, "b"=>200}
</syntaxhighlight>

== انظر أيضا ==
* التابع <code>[[Ruby/Hash/merge!|merge!‎]]</code>: يضيف محتويات الكائن <code>[[Ruby/Hash|Hash]]</code> الذي مُمرِّر إليه إلى الكائن الذي استدعي معه.

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