الدالة ()map_remove في Sass

من موسوعة حسوب

تعيد الدالة 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()‎: تعيد القيمة الموجودة في الخريطة والمرتبطة بالمفتاح المُعطى.

مصادر