الفرق بين المراجعتين لصفحة: «Sass/map merge»
< Sass
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>()map_merge</code> في Sass}}</noinclude> تعيد الدالة <code>map_merge()</code> القيمة المرتبطة...' |
لا ملخص تعديل |
||
| سطر 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>$map1</code> سيكون لها نفس الترتيب كما هو موجود في<code>$map1</code>. ستوضع المفاتيح الجديدة من <code>$map2</code>في نهاية القاموس. | |||
مثل جميع دوال القواميس، فالدالة <code>map_merge()</code> تُعيد قاموسًا جديدًا بدلًا من تعديل معاملاتها موضعيًا. | |||
== البنية العامة == | == البنية العامة == | ||
<syntaxhighlight lang="sass"> | <syntaxhighlight lang="sass"> | ||
map_merge($ | map_merge($map1, $map2) | ||
</syntaxhighlight> | </syntaxhighlight> | ||
== المعاملات == | == المعاملات == | ||
=== <code>$ | === <code>$map1</code> === | ||
القاموس. | القاموس الأول. | ||
=== <code>$ | === <code>$map2</code> === | ||
القاموس الثاني. | |||
== القيم المعادة == | == القيم المعادة == | ||
قاموس ناتج عن دمج القاموسين المُمرّرين. | |||
== الأخطاء والاستثناءات == | == الأخطاء والاستثناءات == | ||
سيُرمى الخطأ <code>ArgumentError</code> إن كان | سيُرمى الخطأ <code>ArgumentError</code> إن كان أيّ من المعاملات غير قاموسٍ. | ||
== أمثلة == | == أمثلة == | ||
مثال عن استخدام الدالة <code>map_merge()</code>:<syntaxhighlight> | مثال عن استخدام الدالة <code>map_merge()</code>:<syntaxhighlight> | ||
map- | map-merge(("foo": 1), ("bar": 2)) => ("foo": 1, "bar": 2) | ||
map- | 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>: تُغيد قاموسًا جديدًا مع حذف المفاتيح. | ||
| سطر 34: | سطر 39: | ||
== مصادر == | == مصادر == | ||
* [https://sass-lang.com/documentation/Sass/Script/Functions.html# | * [https://sass-lang.com/documentation/Sass/Script/Functions.html#map_merge-instance_method قسم الدالة map_merge في صفحة الدوال في توثيق Sass الرسمي.] | ||
[[تصنيف:Sass]] | [[تصنيف:Sass]] | ||
[[تصنيف: Sass Function]] | [[تصنيف: Sass Function]] | ||
مراجعة 14:56، 21 أبريل 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(): تُعيد قائمة مكونة من قيم القاموس.