الفرق بين المراجعتين لصفحة: «Sass/map get»

من موسوعة حسوب
لا ملخص تعديل
لا ملخص تعديل
سطر 18: سطر 18:


== الأخطاء والاستثناءات ==
== الأخطاء والاستثناءات ==
سيُرمى الخطأ <code>ArgumentError</code> إن كان لم يكن المعامل <code>‎$map</code> مفتاحًا.
سيُرمى الخطأ <code>ArgumentError</code> إن كان لم يكن المعامل <code>‎$map</code> قاموسًا.


== أمثلة ==
== أمثلة ==

مراجعة 15:13، 21 أبريل 2018

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

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

map_get($map, $key)

المعاملات

‎$map

القاموس.

‎$key

المفتاح.

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

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

مصادر