الدالة ()map_merge
في Sass
< 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()
: تُعيد قائمة مكونة من قيم القاموس.