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