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