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

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

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

map_get($map, $key)

المعاملات

‎$map

القاموس الذي سنبحث فيه عن القيمة ‎$key.

‎$key

المفتاح الذي سنبحث عنه في القاموس ‎$map.

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

القيمة المُفهرسة بالمفتاح ‎$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()‎: تُعيد قائمة مكونة من قيم القاموس.

مصادر

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