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