الفرق بين المراجعتين لصفحة: «Sass/map merge»

المراجعة الحالية بتاريخ 07:00، 20 مايو 2018

تدمج الدالة map_merge()‎ خريطتين (maps) في خريطة واحدة جديدة. المفاتيح في الخريطة الثانية ‎$map2 ستكون لها الأسبقيَّة على المفاتيح في الخريطة الأولى ‎$map1. هذه هي أفضل طريقة لإضافة قيم جديدة إلى خريطة.

جميع مفاتيح الخريطة الناتجة سيكون لها نفس الترتيب كما في الخريطة الأولى ‎$map1، وستوضع المفاتيح الجديدة للخريطة الثانية ‎$map2 في نهاية تلك الخريطة الناتجة.

تُعيد الدالة map_merge()‎ خريطة جديدة، مثل جميع دوال الخرائط، بدلًا من تعديل معاملاتها موضعيًا.

البنية العامة

map_merge($map1, $map2)

المعاملات

`‎$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()‎: تعيد قائمة تحتوي على قيم الخريطة فقط.
الدالة map_has_key()‎: تتحقَّق إن كانت الخريطة الممرَّرة إليها تحتوي على مفتاح معيّن وهذا المفتاح مرتبط بقيمة ما.
الدالة map_get()‎: تعيد القيمة الموجودة في الخريطة والمرتبطة بالمفتاح المُعطى.

مصادر

قسم الدالة map_merge في صفحة الدوال في توثيق Sass الرسمي.

@@ سطر 1: / سطر 1: @@
 <noinclude>{{DISPLAYTITLE: الدالة <code>()map_merge</code> في Sass}}</noinclude>
-تعيد الدالة <code>map_merge()‎</code> القيمة المرتبطة بالمفتاح المُعطى. إن لم يتضمّن القاموس ذلك المفتاح فستعيد الدالة القيمة المعدومة <code>null</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> خريطة جديدة، مثل جميع دوال الخرائط، بدلًا من تعديل معاملاتها موضعيًا.
 == البنية العامة ==
 <syntaxhighlight lang="sass">
-map_merge($map, $key)
+map_merge($map1, $map2)
 </syntaxhighlight>
 == المعاملات ==
-=== <code>‎$map</code> ===
+=== <code>‎$map1</code> ===
-القاموس.
+الخريطة الأولى.
-=== <code>‎$key</code> ===
+=== <code>‎$map2</code> ===
-المفتاح.
+الخريطة الثانية.
 == القيم المعادة ==
-القيمة المُفهرسة بالمفتاح <code>‎$key</code>، أو القيمة المعدومة <code>null</code> إن لم يتضمّن القاموس المفتاح المحدد
+تُعاد خريطة جديدة ناتجة عن دمج الخريطة <code>‎$map1</code> والخريطة <code>‎$map2</code>.
 == الأخطاء والاستثناءات ==
-سيُرمى الخطأ <code>ArgumentError</code> إن كان لم يكن المعامل <code>‎$map</code> مفتاحًا.
+سيُرمى الخطأ <code>ArgumentError</code> إن لم يكن أيّ من المعاملات الممرَّرة خريطة.
 == أمثلة ==
-مثال عن استخدام الدالة <code>map_merge()‎</code>:<syntaxhighlight>
+مثال عن استخدام الدالة <code>map_merge()‎</code>:<syntaxhighlight lang="sass">
-map-get(("foo": 1, "bar": 2), "foo") => 1
+map-merge(("foo": 1), ("bar": 2)) // ("foo": 1, "bar": 2)
-map-get(("foo": 1, "bar": 2), "bar") => 2
+map-merge(("foo": 1, "bar": 2), ("bar": 3)) // ("foo": 1, "bar": 3)
-map-get(("foo": 1, "bar": 2), "baz") => null
 </syntaxhighlight>
 == انظر أيضًا ==
-* الدالة <code>[[Sass/round|map_merge()]]</code>‎: تدمج قاموسين في قاموس واحدٍ.
+* الدالة <code>[[Sass/map remove|map_remove()]]</code>‎: تعيد خريطة مع حذف مفاتيح محدَّدة منها.
-* الدالة <code>[[Sass/map remove|map_remove()]]</code>‎: تُغيد قاموسًا جديدًا مع حذف المفاتيح.
+* الدالة <code>[[Sass/map keys|map_keys()]]</code>‎: تعيد قائمة تحتوي على مفاتيح الخريطة فقط.
+* الدالة <code>[[Sass/map values|map_values()]]</code>‎: تعيد قائمة تحتوي على قيم الخريطة فقط.
-* الدالة <code>[[Sass/map keys|map_keys()]]</code>‎: تُعيد قائمة مكونة من مفاتيح القاموس.
+* الدالة <code>[[Sass/map has key|map_has_key()‎]]</code>: تتحقَّق إن كانت الخريطة الممرَّرة إليها تحتوي على مفتاح معيّن وهذا المفتاح مرتبط بقيمة ما.
-* الدالة <code>[[Sass/max|map_values()]]</code>‎: تُعيد قائمة مكونة من قيم القاموس.
+* الدالة <code>[[Sass/map get|map_get()‎]]</code>: تعيد القيمة الموجودة في الخريطة والمرتبطة بالمفتاح المُعطى.
 == مصادر ==
-* [https://sass-lang.com/documentation/Sass/Script/Functions.html#map_get-instance_method قسم الدالة map_merge في صفحة الدوال في توثيق Sass الرسمي.]
+* [https://sass-lang.com/documentation/Sass/Script/Functions.html#map_merge-instance_method قسم الدالة map_merge في صفحة الدوال في توثيق Sass الرسمي].
-[[تصنيف:Sass]]
+[[تصنيف:Sass|{{SUBPAGENAME}}]]
-[[تصنيف: Sass Function]]
+[[تصنيف: Sass Function|{{SUBPAGENAME}}]]