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

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

تعيد الدالة map_get()‎ القيمة المرتبطة بالمفتاح المُعطى. إن لم يتضمّن القاموس ذلك المفتاح فستعيد الدالة القيمة المعدومة null.

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

map_get($map, $key)

المعاملات

‎$map

القاموس.

‎$key

المفتاح.

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

القيمة المُفهرسة بالمفتاح ‎$key، أو القيمة المعدومة null إن لم يتضمّن القاموس المفتاح المحدد

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

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

أمثلة

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

map-get(("foo": 1, "bar": 2), "foo") => 1
map-get(("foo": 1, "bar": 2), "bar") => 2
map-get(("foo": 1, "bar": 2), "baz") => null

انظر أيضًا

  • الدالة map_merge()‎: تدمج قاموسين في قاموس واحدٍ.
  • الدالة map_remove()‎: تُغيد قاموسًا جديدًا مع حذف المفاتيح.
  • الدالة map_keys()‎: تُعيد قائمة مكونة من مفاتيح القاموس.
  • الدالة map_values()‎: تُعيد قائمة مكونة من قيم القاموس.

مصادر