الفرق بين المراجعتين لصفحة: «Sass/map merge»
< Sass
لا ملخص تعديل |
لا ملخص تعديل |
||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: الدالة <code>()map_merge</code> في Sass}}</noinclude> | <noinclude>{{DISPLAYTITLE: الدالة <code>()map_merge</code> في Sass}}</noinclude> | ||
تدمج الدالة <code>map_merge()</code> قاموسين في قاموسٍ جديدٍ. المفاتيح في القاموس <code>$map2</code>ستكون لها الأسبقية على المفاتيح في القاموس<code>$map1</code>. | تدمج الدالة <code>map_merge()</code> قاموسين في قاموسٍ جديدٍ. المفاتيح في القاموس <code>$map2</code>ستكون لها الأسبقية على المفاتيح في القاموس <code>$map1</code>. هذه هي أفضل طريقة لإضافة قيم جديدة إلى قاموس. | ||
هذه هي أفضل طريقة لإضافة قيم جديدة إلى قاموس. | |||
جميع مفاتيح القاموس الناتج والتي توجد أيضًا في <code>$map1</code> سيكون لها نفس الترتيب كما هو موجود في<code>$map1</code>. ستوضع المفاتيح الجديدة من <code>$map2</code>في نهاية القاموس. | جميع مفاتيح القاموس الناتج والتي توجد أيضًا في <code>$map1</code> سيكون لها نفس الترتيب كما هو موجود في<code>$map1</code>. ستوضع المفاتيح الجديدة من <code>$map2</code>في نهاية القاموس. | ||
ومثل جميع دوال القواميس، فالدالة <code>map_merge()</code> تُعيد قاموسًا جديدًا بدلًا من تعديل معاملاتها موضعيًا. | |||
== البنية العامة == | == البنية العامة == | ||
| سطر 28: | سطر 26: | ||
== أمثلة == | == أمثلة == | ||
مثال عن استخدام الدالة <code>map_merge()</code>:<syntaxhighlight> | مثال عن استخدام الدالة <code>map_merge()</code>:<syntaxhighlight lang="sass"> | ||
map-merge(("foo": 1), ("bar": 2)) | map-merge(("foo": 1), ("bar": 2)) // ("foo": 1, "bar": 2) | ||
map-merge(("foo": 1, "bar": 2), ("bar": 3)) | map-merge(("foo": 1, "bar": 2), ("bar": 3)) // ("foo": 1, "bar": 3) | ||
</syntaxhighlight> | </syntaxhighlight> | ||
== انظر أيضًا == | == انظر أيضًا == | ||
* الدالة <code>[[Sass/map remove|map_remove()]]</code>: تُغيد قاموسًا جديدًا مع حذف المفاتيح. | * الدالة <code>[[Sass/map remove|map_remove()]]</code>: تُغيد قاموسًا جديدًا مع حذف المفاتيح. | ||
* الدالة <code>[[Sass/map keys|map_keys()]]</code>: تُعيد قائمة مكونة من مفاتيح القاموس. | * الدالة <code>[[Sass/map keys|map_keys()]]</code>: تُعيد قائمة مكونة من مفاتيح القاموس. | ||
* الدالة <code>[[Sass/map values|map_values()]]</code>: تُعيد قائمة مكونة من قيم القاموس. | * الدالة <code>[[Sass/map values|map_values()]]</code>: تُعيد قائمة مكونة من قيم القاموس. | ||
مراجعة 02:50، 22 أبريل 2018
تدمج الدالة 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(): تُعيد قائمة مكونة من قيم القاموس.