الفرق بين المراجعتين ل"Sass/map get"
< Sass
اذهب إلى التنقل
اذهب إلى البحث
جميل-بيلوني (نقاش | مساهمات) ط (مراجعة الصفحة وتدقيقها.) |
|||
| سطر 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> خريطة. |
== أمثلة == | == أمثلة == | ||
| − | + | المثال 1: استخدام الدالة <code>map_get()</code>.<syntaxhighlight lang="sass"> | |
map-get(("foo": 1, "bar": 2), "foo") // 1 | map-get(("foo": 1, "bar": 2), "foo") // 1 | ||
map-get(("foo": 1, "bar": 2), "bar") // 2 | map-get(("foo": 1, "bar": 2), "bar") // 2 | ||
| سطر 27: | سطر 27: | ||
</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>: تُعيد قائمة تحتوي على قيم الخريطة فقط. |
== مصادر == | == مصادر == | ||
مراجعة 12:33، 3 مايو 2018
تعيد الدالة map_get() القيمة الموجودة في الخريطة (map) والمرتبطة بالمفتاح المُعطى. إن لم تحتوي الخريطة على ذلك المفتاح، فستعيد الدالة القيمة العدميَّة null.
البنية العامة
map_get($map, $key)
المعاملات
$map
الخريطة المراد جلب القيمة المرتبطة بالمفتاح $key منها.
$key
المفتاح المراد البحث عنه في الخريطة $map.
القيم المعادة
تُعاد القيمة المرتبطة بالمفتاح $key في الخريطة $map، أو القيمة العدمية null إن لم تحتوي الخريطة على ذلك المفتاح.
الأخطاء والاستثناءات
سيُرمى الخطأ ArgumentError إن لم يكن المعامل $map خريطة.
أمثلة
المثال 1: استخدام الدالة 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(): تُعيد قائمة تحتوي على قيم الخريطة فقط.