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

مراجعة 15:14، 21 أبريل 2018

تعيد الدالة map_remove()‎ قاموسًا جديدًا بعد حذف المفاتيح.

مثل جميع دوال القواميس، فالدالة map_remove()‎ تُعيد قاموسًا جديدًا بدلًا من تعديل معاملاتها موضعيًا.

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

map_remove($map, $keys...)

المعاملات

`‎$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_remove في صفحة الدوال في توثيق Sass الرسمي.

@@ سطر 1: / سطر 1: @@
 <noinclude>{{DISPLAYTITLE: الدالة <code>()map_remove</code> في Sass}}</noinclude>
-تعيد الدالة <code>map_remove()‎</code> القيمة المرتبطة بالمفتاح المُعطى. إن لم يتضمّن القاموس ذلك المفتاح فستعيد الدالة القيمة المعدومة <code>null</code>.
+تعيد الدالة <code>map_remove()‎</code> قاموسًا جديدًا بعد حذف المفاتيح.
+مثل جميع دوال القواميس، فالدالة <code>map_remove()‎</code> تُعيد قاموسًا جديدًا بدلًا من تعديل معاملاتها موضعيًا.
 == البنية العامة ==
 <syntaxhighlight lang="sass">
-map_remove($map, $key)
+map_remove($map, $keys...)
 </syntaxhighlight>
@@ سطر 11: / سطر 13: @@
 القاموس.
-=== <code>‎$key</code> ===
+=== <code>‎$keys</code> ===
-المفتاح.
+المفاتيح.
 == القيم المعادة ==
-القيمة المُفهرسة بالمفتاح <code>‎$key</code>، أو القيمة المعدومة <code>null</code> إن لم يتضمّن القاموس المفتاح المحدد
+قاموسًا جديدًا بعد حذف المفاتيح.
 == الأخطاء والاستثناءات ==
-سيُرمى الخطأ <code>ArgumentError</code> إن كان لم يكن المعامل <code>‎$map</code> مفتاحًا.
+سيُرمى الخطأ <code>ArgumentError</code> إن كان لم يكن المعامل <code>‎$map</code> قاموسًا.
 == أمثلة ==
 مثال عن استخدام الدالة <code>map_remove()‎</code>:<syntaxhighlight>
-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 remove|map_remove()]]</code>‎: تُغيد قاموسًا جديدًا مع حذف المفاتيح.
 * الدالة <code>[[Sass/map keys|map_keys()]]</code>‎: تُعيد قائمة مكونة من مفاتيح القاموس.