الدالة ()map_merge في Sass

من موسوعة حسوب

تدمج الدالة map_merge()‎ قاموسين في قاموسٍ جديدٍ. المفاتيح في القاموس ‎$map2ستكون لها الأسبقية على المفاتيح في القاموس‎$map1.

هذه هي أفضل طريقة لإضافة قيم جديدة إلى قاموس.

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

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

البنية العامة

map_merge($map1, $map2)

المعاملات

‎$map1

القاموس الأول.

‎$map2

القاموس الثاني.

القيم المعادة

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

الأخطاء والاستثناءات

سيُرمى الخطأ ArgumentError إن كان أيّ من المعاملات غير قاموسٍ.

أمثلة

مثال عن استخدام الدالة map_merge()‎:

map-merge(("foo": 1), ("bar": 2)) => ("foo": 1, "bar": 2)
map-merge(("foo": 1, "bar": 2), ("bar": 3)) => ("foo": 1, "bar": 3)

انظر أيضًا

  • الدالة map_remove()‎: تُغيد قاموسًا جديدًا مع حذف المفاتيح.
  • الدالة map_keys()‎: تُعيد قائمة مكونة من مفاتيح القاموس.
  • الدالة map_values()‎: تُعيد قائمة مكونة من قيم القاموس.

مصادر