الفرق بين المراجعتين ل"Sass/map get"
< Sass
اذهب إلى التنقل
اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>()map_get</code> في Sass}}</noinclude> تعيد الدالة <code>map_get()</code> القيمة الأصغر بين...') |
ط (استبدال النص - '\[\[تصنيف:(.*)\]\]' ب'{{SUBPAGENAME}}') |
||
(6 مراجعات متوسطة بواسطة 3 مستخدمين غير معروضة) | |||
سطر 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"> | ||
− | map_get($ | + | map_get($map, $key) |
</syntaxhighlight> | </syntaxhighlight> | ||
== المعاملات == | == المعاملات == | ||
− | === <code>$ | + | === <code>$map</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> | + | مثال عن استخدام الدالة <code>map_get()</code>:<syntaxhighlight lang="sass"> |
− | + | 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|{{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()
: تُعيد قائمة تحتوي على قيم الخريطة فقط.