الفرق بين المراجعتين لصفحة: «Sass/map get»
< Sass
لا ملخص تعديل |
ط استبدال النص - '\[\[تصنيف:(.*)\]\]' ب'{{SUBPAGENAME}}' |
||
| (4 مراجعات متوسطة بواسطة مستخدمين اثنين آخرين غير معروضة) | |||
| سطر 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> القيمة الموجودة في [[Sass/SassScript#.D8.A7.D9.84.D8.AE.D8.B1.D8.A7.D8.A6.D8.B7 .28Maps.29|الخريطة]] (map) والمرتبطة بالمفتاح المُعطى. إن لم تحتوي الخريطة على ذلك المفتاح، فستعيد الدالة القيمة العدميَّة <code>null</code>. | ||
== البنية العامة == | == البنية العامة == | ||
<syntaxhighlight lang="sass"> | <syntaxhighlight lang="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>$map</code>، أو القيمة العدمية <code>null</code> إن لم تحتوي الخريطة على ذلك المفتاح. | ||
== الأخطاء والاستثناءات == | == الأخطاء والاستثناءات == | ||
سيُرمى الخطأ <code>ArgumentError</code> إن | سيُرمى الخطأ <code>ArgumentError</code> إن لم يكن المعامل <code>$map</code> خريطة. | ||
== أمثلة == | == أمثلة == | ||
مثال عن استخدام الدالة <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> | ||
== انظر أيضًا == | == انظر أيضًا == | ||
* الدالة <code>[[Sass/round|map_merge()]]</code>: تدمج | * الدالة <code>[[Sass/round|map_merge()]]</code>: تدمج خريطتين في خريطة واحدة. | ||
* الدالة <code>[[Sass/map remove|map_remove()]]</code>: | * الدالة <code>[[Sass/map remove|map_remove()]]</code>: تعيد خريطة بعد حذف مفاتيح محدَّدة منها. | ||
* الدالة <code>[[Sass/map keys|map_keys()]]</code>: تُعيد قائمة | * الدالة <code>[[Sass/map keys|map_keys()]]</code>: تُعيد قائمة تحتوي على مفاتيح الخريطة فقط. | ||
* الدالة <code>[[Sass/max|map_values()]]</code>: تُعيد قائمة | * الدالة <code>[[Sass/max|map_values()]]</code>: تُعيد قائمة تحتوي على قيم الخريطة فقط. | ||
== مصادر == | == مصادر == | ||
* [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|{{SUBPAGENAME}}]] | ||
[[تصنيف: Sass Function]] | [[تصنيف: Sass Function|{{SUBPAGENAME}}]] | ||
المراجعة الحالية بتاريخ 07:01، 20 مايو 2018
تعيد الدالة map_get() القيمة الموجودة في الخريطة (map) والمرتبطة بالمفتاح المُعطى. إن لم تحتوي الخريطة على ذلك المفتاح، فستعيد الدالة القيمة العدميَّة null.
البنية العامة
map_get($map, $key)
المعاملات
$map
الخريطة المراد جلب القيمة المرتبطة بالمفتاح $key منها.
$key
المفتاح المراد البحث عنه في الخريطة $map.
القيم المعادة
تُعاد القيمة المرتبطة بالمفتاح $key في الخريطة $map، أو القيمة العدمية 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(): تُعيد قائمة تحتوي على قيم الخريطة فقط.