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

من موسوعة حسوب
< Sass
مراجعة 12:33، 3 مايو 2018 بواسطة جميل-بيلوني (نقاش | مساهمات) (مراجعة الصفحة وتدقيقها.)
اذهب إلى التنقل اذهب إلى البحث

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

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

map_get($map, $key)

المعاملات

‎$map

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

‎$key

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

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

تُعاد القيمة المرتبطة بالمفتاح ‎$key في الخريطة ‎$map، أو القيمة العدمية null إن لم تحتوي الخريطة على ذلك المفتاح.

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

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

أمثلة

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

مصادر