الفرق بين المراجعتين لصفحة: «Sass/map get»
< Sass
لا ملخص تعديل |
لا ملخص تعديل |
||
| سطر 9: | سطر 9: | ||
=== <code>$map</code> === | === <code>$map</code> === | ||
القاموس. | القاموس الذي سنبحث فيه عن القيمة <code>$key</code>. | ||
=== <code>$key</code> === | === <code>$key</code> === | ||
المفتاح. | المفتاح الذي سنبحث عنه في القاموس <code>$map</code>. | ||
== القيم المعادة == | == القيم المعادة == | ||
القيمة المُفهرسة بالمفتاح <code>$key</code>، أو القيمة المعدومة <code>null</code> إن لم يتضمّن القاموس المفتاح المحدد | القيمة المُفهرسة بالمفتاح <code>$key</code>، أو القيمة المعدومة <code>null</code> إن لم يتضمّن القاموس المفتاح المحدد. | ||
== الأخطاء والاستثناءات == | == الأخطاء والاستثناءات == | ||
| سطر 21: | سطر 21: | ||
== أمثلة == | == أمثلة == | ||
مثال عن استخدام الدالة <code>map_get()</code>:<syntaxhighlight> | مثال عن استخدام الدالة <code>map_get()</code>:<syntaxhighlight lang="sass"> | ||
map-get(("foo": 1, "bar": 2), "foo") | map-get(("foo": 1, "bar": 2), "foo") // 1 | ||
map-get(("foo": 1, "bar": 2), "bar") | map-get(("foo": 1, "bar": 2), "bar") // 2 | ||
map-get(("foo": 1, "bar": 2), "baz") | map-get(("foo": 1, "bar": 2), "baz") // null | ||
</syntaxhighlight> | </syntaxhighlight> | ||
== انظر أيضًا == | == انظر أيضًا == | ||
| سطر 34: | سطر 34: | ||
== مصادر == | == مصادر == | ||
* [https://sass-lang.com/documentation/Sass/Script/Functions.html#map_get-instance_method قسم الدالة | * [https://sass-lang.com/documentation/Sass/Script/Functions.html#map_get-instance_method قسم الدالة map_get في صفحة الدوال في توثيق Sass الرسمي.] | ||
[[تصنيف:Sass]] | [[تصنيف:Sass]] | ||
[[تصنيف: Sass Function]] | [[تصنيف: Sass Function]] | ||
مراجعة 02:41، 22 أبريل 2018
تعيد الدالة map_get() القيمة المرتبطة بالمفتاح المُعطى. إن لم يتضمّن القاموس ذلك المفتاح فستعيد الدالة القيمة المعدومة null.
البنية العامة
map_get($map, $key)
المعاملات
$map
القاموس الذي سنبحث فيه عن القيمة $key.
$key
المفتاح الذي سنبحث عنه في القاموس $map.
القيم المعادة
القيمة المُفهرسة بالمفتاح $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(): تُعيد قائمة مكونة من قيم القاموس.