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

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

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

map_get($map, $key)

المعاملات

‎$map

الخريطة المراد جلب القيمة المرتبطة بالمفتاح ‎$key منها.

‎$key

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

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

تُعاد القيمة المرتبطة بالمفتاح ‎$key في الخريطة ‎$map، أو القيمة العدمية 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 الرسمي.