عرض مصدر Sass/map merge

<noinclude>{{DISPLAYTITLE: الدالة <code>()map_merge</code> في Sass}}</noinclude>
تدمج الدالة <code>map_merge()‎</code> قاموسين في قاموسٍ جديدٍ. المفاتيح في القاموس <code>‎$map2</code>ستكون لها الأسبقية على المفاتيح في القاموس <code>‎$map1</code>. هذه هي أفضل طريقة لإضافة قيم جديدة إلى قاموس.

جميع مفاتيح القاموس الناتج والتي توجد أيضًا في <code>‎$map1</code> سيكون لها نفس الترتيب كما هو موجود في<code>‎$map1</code>. ستوضع المفاتيح الجديدة من <code>‎$map2</code>في نهاية القاموس.

ومثل جميع دوال القواميس، فالدالة <code>map_merge()‎</code> تُعيد قاموسًا جديدًا بدلًا من تعديل معاملاتها موضعيًا.

== البنية العامة ==
<syntaxhighlight lang="sass">
map_merge($map1, $map2)
</syntaxhighlight>

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

=== <code>‎$map1</code> ===
القاموس الأول.

=== <code>‎$map2</code> ===
القاموس الثاني.

== القيم المعادة ==
قاموس ناتج عن دمج القاموسين المُمرّرين.

== الأخطاء والاستثناءات ==
سيُرمى الخطأ <code>ArgumentError</code> إن كان أيّ من المعاملات غير قاموسٍ.

== أمثلة ==
مثال عن استخدام الدالة <code>map_merge()‎</code>:<syntaxhighlight lang="sass">
map-merge(("foo": 1), ("bar": 2)) // ("foo": 1, "bar": 2)
map-merge(("foo": 1, "bar": 2), ("bar": 3)) // ("foo": 1, "bar": 3)
</syntaxhighlight>
== انظر أيضًا ==
* الدالة <code>[[Sass/map remove|map_remove()]]</code>‎: تُغيد قاموسًا جديدًا مع حذف المفاتيح.
* الدالة <code>[[Sass/map keys|map_keys()]]</code>‎: تُعيد قائمة مكونة من مفاتيح القاموس.
* الدالة <code>[[Sass/map values|map_values()]]</code>‎: تُعيد قائمة مكونة من قيم القاموس.

== مصادر ==
* [https://sass-lang.com/documentation/Sass/Script/Functions.html#map_merge-instance_method قسم الدالة map_merge في صفحة الدوال في توثيق Sass الرسمي.]
[[تصنيف:Sass]]
[[تصنيف: Sass Function]]