الفرق بين المراجعتين لصفحة: «Sass/map get»
< Sass
لا ملخص تعديل |
لا ملخص تعديل |
||
سطر 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()
: تُعيد قائمة مكونة من قيم القاموس.