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

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

تعيد الدالة map_remove()‎ خريطة (map) جديدة بعد حذف مفاتيح معيّنة من الخريطة الممرَّرة إليها.

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

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

map_remove($map, $keys...)

المعاملات

`‎$map`

الخريطة المراد حذف مفاتيح محدَّدة منها.

`‎$keys`

المفاتيح المراد حذفها من الخريطة ‎$map.

القيم المعادة

تُعاد خريطة الخريطة ‎$map بعد حذف المفاتيح ‎$keys منها.

الأخطاء والاستثناءات

سيُرمى الخطأ ArgumentError إن لم يكن المعامل ‎$map خريطةً.

أمثلة

مثال عن استخدام الدالة map_remove()‎:

map-remove(("foo": 1, "bar": 2), "bar") // ("foo": 1)
map-remove(("foo": 1, "bar": 2, "baz": 3), "bar", "baz") // ("foo": 1)
map-remove(("foo": 1, "bar": 2), "baz") // ("foo": 1, "bar": 2)

انظر أيضًا

الدالة map_merge()‎: تدمج خريطتين في خريطة واحدة.
الدالة map_keys()‎: تعيد قائمة تحتوي على مفاتيح الخريطة فقط.
الدالة map_values()‎: تعيد قائمة تحتوي على قيم الخريطة فقط.
الدالة map_has_key()‎: تتحقَّق إن كانت الخريطة الممرَّرة إليها تحتوي على مفتاح معيّن وهذا المفتاح مرتبط بقيمة ما.
الدالة map_get()‎: تعيد القيمة الموجودة في الخريطة والمرتبطة بالمفتاح المُعطى.

مصادر

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

@@ سطر 1: / سطر 1: @@
 <noinclude>{{DISPLAYTITLE: الدالة <code>()map_remove</code> في Sass}}</noinclude>
-تعيد الدالة <code>map_remove()‎</code> القيمة المرتبطة بالمفتاح المُعطى. إن لم يتضمّن القاموس ذلك المفتاح فستعيد الدالة القيمة المعدومة <code>null</code>.
+تعيد الدالة <code>map_remove()‎</code> [[Sass/SassScript#.D8.A7.D9.84.D8.AE.D8.B1.D8.A7.D8.A6.D8.B7 .28Maps.29|خريطة]] (map) جديدة بعد حذف مفاتيح معيّنة من الخريطة الممرَّرة إليها.
+تُعيد الدالة <code>map_remove()‎</code> خريطة جديدة، مثل جميع دوال الخرائط، بدلًا من تعديل معاملاتها موضعيًا.
 == البنية العامة ==
 <syntaxhighlight lang="sass">
-map_remove($map, $key)
+map_remove($map, $keys...)
 </syntaxhighlight>
@@ سطر 9: / سطر 11: @@
 === <code>‎$map</code> ===
-القاموس.
+الخريطة المراد حذف مفاتيح محدَّدة منها.
-=== <code>‎$key</code> ===
+=== <code>‎$keys</code> ===
-المفتاح.
+المفاتيح المراد حذفها من الخريطة <code>‎$map</code>.
 == القيم المعادة ==
-القيمة المُفهرسة بالمفتاح <code>‎$key</code>، أو القيمة المعدومة <code>null</code> إن لم يتضمّن القاموس المفتاح المحدد
+تُعاد خريطة الخريطة <code>‎$map</code> بعد حذف المفاتيح <code>‎$keys</code> منها.
 == الأخطاء والاستثناءات ==
-سيُرمى الخطأ <code>ArgumentError</code> إن كان لم يكن المعامل <code>‎$map</code> مفتاحًا.
+سيُرمى الخطأ <code>ArgumentError</code> إن لم يكن المعامل <code>‎$map</code> خريطةً.
 == أمثلة ==
-مثال عن استخدام الدالة <code>map_remove()‎</code>:<syntaxhighlight>
+مثال عن استخدام الدالة <code>map_remove()‎</code>:<syntaxhighlight lang="sass">
-map-get(("foo": 1, "bar": 2), "foo") => 1
+map-remove(("foo": 1, "bar": 2), "bar") // ("foo": 1)
-map-get(("foo": 1, "bar": 2), "bar") => 2
+map-remove(("foo": 1, "bar": 2, "baz": 3), "bar", "baz") // ("foo": 1)
-map-get(("foo": 1, "bar": 2), "baz") => null
+map-remove(("foo": 1, "bar": 2), "baz") // ("foo": 1, "bar": 2)
 </syntaxhighlight>
 == انظر أيضًا ==
-* الدالة <code>[[Sass/round|map_merge()]]</code>‎: تدمج قاموسين في قاموس واحدٍ.
+* الدالة <code>[[Sass/map merge|map_merge()]]</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_remove-instance_method قسم الدالة map_remove في صفحة الدوال في توثيق Sass الرسمي.]
+* [https://sass-lang.com/documentation/Sass/Script/Functions.html#map_remove-instance_method قسم الدالة map_remove في صفحة الدوال في توثيق Sass الرسمي].
-[[تصنيف:Sass]]
+[[تصنيف:Sass|{{SUBPAGENAME}}]]
-[[تصنيف: Sass Function]]
+[[تصنيف: Sass Function|{{SUBPAGENAME}}]]