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