الفرق بين المراجعتين ل"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>map_merge()</code> [[Sass/SassScript#.D8.A7.D9.84.D8.AE.D8.B1.D8.A7.D8.A6.D8.B7 .28Maps.29|خريطتين]] (maps) في خريطة واحدة جديدة. المفاتيح في الخريطة الثانية <code>$map2</code> ستكون لها الأسبقيَّة على المفاتيح في الخريطة الأولى <code>$map1</code>. هذه هي أفضل طريقة لإضافة قيم جديدة إلى خريطة. |
| − | جميع مفاتيح | + | جميع مفاتيح الخريطة الناتجة سيكون لها نفس الترتيب كما في الخريطة الأولى <code>$map1</code>، وستوضع المفاتيح الجديدة للخريطة الثانية <code>$map2</code> في نهاية تلك الخريطة الناتجة. |
| − | + | تُعيد الدالة <code>map_merge()</code> خريطة جديدة، مثل جميع دوال الخرائط، بدلًا من تعديل معاملاتها موضعيًا. | |
== البنية العامة == | == البنية العامة == | ||
| سطر 14: | سطر 14: | ||
=== <code>$map1</code> === | === <code>$map1</code> === | ||
| − | + | الخريطة الأولى. | |
=== <code>$map2</code> === | === <code>$map2</code> === | ||
| − | + | الخريطة الثانية. | |
== القيم المعادة == | == القيم المعادة == | ||
| − | + | تُعاد خريطة جديدة ناتجة عن دمج الخريطة <code>$map1</code> والخريطة <code>$map2</code>. | |
== الأخطاء والاستثناءات == | == الأخطاء والاستثناءات == | ||
| − | سيُرمى الخطأ <code>ArgumentError</code> إن | + | سيُرمى الخطأ <code>ArgumentError</code> إن لم يكن أيّ من المعاملات الممرَّرة خريطة. |
== أمثلة == | == أمثلة == | ||
| − | + | المثال 1: استخدام الدالة <code>map_merge()</code>.<syntaxhighlight lang="sass"> | |
map-merge(("foo": 1), ("bar": 2)) // ("foo": 1, "bar": 2) | map-merge(("foo": 1), ("bar": 2)) // ("foo": 1, "bar": 2) | ||
map-merge(("foo": 1, "bar": 2), ("bar": 3)) // ("foo": 1, "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>: تعيد قائمة تحتوي على قيم الخريطة فقط. |
| + | * الدالة <code>[[Sass/map has key|map_has_key()]]</code>: تتحقَّق إن كانت الخريطة الممرَّرة إليها تحتوي على مفتاح معيّن وهذا المفتاح مرتبط بقيمة ما. | ||
| + | * الدالة <code>[[Sass/map get|map_get()]]</code>: تعيد القيمة الموجودة في الخريطة والمرتبطة بالمفتاح المُعطى. | ||
== مصادر == | == مصادر == | ||
مراجعة 13:09، 3 مايو 2018
تدمج الدالة map_merge() خريطتين (maps) في خريطة واحدة جديدة. المفاتيح في الخريطة الثانية $map2 ستكون لها الأسبقيَّة على المفاتيح في الخريطة الأولى $map1. هذه هي أفضل طريقة لإضافة قيم جديدة إلى خريطة.
جميع مفاتيح الخريطة الناتجة سيكون لها نفس الترتيب كما في الخريطة الأولى $map1، وستوضع المفاتيح الجديدة للخريطة الثانية $map2 في نهاية تلك الخريطة الناتجة.
تُعيد الدالة map_merge() خريطة جديدة، مثل جميع دوال الخرائط، بدلًا من تعديل معاملاتها موضعيًا.
البنية العامة
map_merge($map1, $map2)
المعاملات
$map1
الخريطة الأولى.
$map2
الخريطة الثانية.
القيم المعادة
تُعاد خريطة جديدة ناتجة عن دمج الخريطة $map1 والخريطة $map2.
الأخطاء والاستثناءات
سيُرمى الخطأ ArgumentError إن لم يكن أيّ من المعاملات الممرَّرة خريطة.
أمثلة
المثال 1: استخدام الدالة 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(): تعيد قائمة تحتوي على قيم الخريطة فقط. - الدالة
map_has_key(): تتحقَّق إن كانت الخريطة الممرَّرة إليها تحتوي على مفتاح معيّن وهذا المفتاح مرتبط بقيمة ما. - الدالة
map_get(): تعيد القيمة الموجودة في الخريطة والمرتبطة بالمفتاح المُعطى.