الفرق بين المراجعتين ل"Sass/map get"
< Sass
اذهب إلى التنقل
اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>()map_get</code> في Sass}}</noinclude> تعيد الدالة <code>map_get()</code> القيمة الأصغر بين...') |
|||
سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: الدالة <code>()map_get</code> في Sass}}</noinclude> | <noinclude>{{DISPLAYTITLE: الدالة <code>()map_get</code> في Sass}}</noinclude> | ||
− | تعيد الدالة <code>map_get()</code> القيمة | + | تعيد الدالة <code>map_get()</code> القيمة المرتبطة بالمفتاح المُعطى. إن لم يتضمّن القاموس ذلك المفتاح فستعيد الدالة القيمة المعدومة <code>null</code>. |
== البنية العامة == | == البنية العامة == | ||
<syntaxhighlight lang="sass"> | <syntaxhighlight lang="sass"> | ||
− | map_get($ | + | map_get($map, $key) |
</syntaxhighlight> | </syntaxhighlight> | ||
== المعاملات == | == المعاملات == | ||
− | === <code>$ | + | === <code>$map</code> === |
− | + | القاموس. | |
+ | |||
+ | === <code>$key</code> === | ||
+ | المفتاح. | ||
== القيم المعادة == | == القيم المعادة == | ||
− | + | القيمة المُفهرسة بالمفتاح <code>$key</code>، أو القيمة المعدومة <code>null</code> إن لم يتضمّن القاموس المفتاح المحدد | |
== الأخطاء والاستثناءات == | == الأخطاء والاستثناءات == | ||
− | سيُرمى الخطأ <code>ArgumentError</code> إن كان | + | سيُرمى الخطأ <code>ArgumentError</code> إن كان لم يكن المعامل <code>$map</code> مفتاحًا. |
== أمثلة == | == أمثلة == | ||
− | مثال عن استخدام الدالة <code> | + | مثال عن استخدام الدالة <code>map_get()</code>:<syntaxhighlight> |
− | + | map-get(("foo": 1, "bar": 2), "foo") => 1 | |
− | + | map-get(("foo": 1, "bar": 2), "bar") => 2 | |
− | + | map-get(("foo": 1, "bar": 2), "baz") => null | |
− | |||
− | |||
− | |||
− | |||
</syntaxhighlight> | </syntaxhighlight> | ||
− | |||
== انظر أيضًا == | == انظر أيضًا == | ||
− | * الدالة <code>[[Sass/round| | + | * الدالة <code>[[Sass/round|map_merge()]]</code>: تدمج قاموسين في قاموس واحدٍ. |
− | * الدالة <code>[[Sass/ | + | * الدالة <code>[[Sass/map remove|map_remove()]]</code>: تُغيد قاموسًا جديدًا مع حذف المفاتيح. |
− | * الدالة <code>[[Sass/ | + | * الدالة <code>[[Sass/map keys|map_keys()]]</code>: تُعيد قائمة مكونة من مفاتيح القاموس. |
− | * الدالة <code>[[Sass/max| | + | * الدالة <code>[[Sass/max|map_values()]]</code>: تُعيد قائمة مكونة من قيم القاموس. |
== مصادر == | == مصادر == | ||
− | * [https://sass-lang.com/documentation/Sass/Script/Functions.html# | + | * [https://sass-lang.com/documentation/Sass/Script/Functions.html#map_get-instance_method قسم الدالة map-get في صفحة الدوال في توثيق Sass الرسمي.] |
[[تصنيف:Sass]] | [[تصنيف:Sass]] | ||
[[تصنيف: Sass Function]] | [[تصنيف: Sass Function]] |
مراجعة 14:41، 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()
: تُعيد قائمة مكونة من قيم القاموس.