الفرق بين المراجعتين لصفحة: «Sass/map get»

المراجعة الحالية بتاريخ 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()‎: تُعيد قائمة تحتوي على قيم الخريطة فقط.

مصادر

قسم الدالة map_get في صفحة الدوال في توثيق Sass الرسمي.

@@ سطر 1: / سطر 1: @@
 <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">
-map_get($numbers...)
+map_get($map, $key)
 </syntaxhighlight>
 == المعاملات ==
-=== <code>‎$numbers</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>min()‎</code>  لضبط قيمة العرض (<code>[[CSS/width|width]]</code>):<syntaxhighlight lang="sass">
+مثال عن استخدام الدالة <code>map_get()‎</code>:<syntaxhighlight lang="sass">
-selector {
+map-get(("foo": 1, "bar": 2), "foo") // 1
-  width: min(10px, 40px) // 10px
+map-get(("foo": 1, "bar": 2), "bar") // 2
-}
+map-get(("foo": 1, "bar": 2), "baz") // null
-</syntaxhighlight>سيُصرّف المثال السابق إلى شيفرة <nowiki/>[[CSS]] الآتية:<syntaxhighlight lang="css">
-selector {
-  width: 10px;
-}
 </syntaxhighlight>
 == انظر أيضًا ==
-* الدالة <code>[[Sass/round|round()]]</code>‎: تُعيد العدد الصحيح الأقرب.
+* الدالة <code>[[Sass/round|map_merge()]]</code>‎: تدمج خريطتين في خريطة واحدة.
-* الدالة <code>[[Sass/percentage|percentage()]]</code>‎: تُحول عددا إلى نسبة مئوية.
+* الدالة <code>[[Sass/map remove|map_remove()]]</code>‎: تعيد خريطة بعد حذف مفاتيح محدَّدة منها.
-* الدالة <code>[[Sass/abs|abs()]]</code>‎: تُعيد القيمة المطلقة.
+* الدالة <code>[[Sass/map keys|map_keys()]]</code>‎: تُعيد قائمة تحتوي على مفاتيح الخريطة فقط.
-* الدالة <code>[[Sass/max|max()]]</code>‎: تُعيد القيمة الأكبر بين مجموعة من الأعداد.
+* الدالة <code>[[Sass/max|map_values()]]</code>‎: تُعيد قائمة تحتوي على قيم الخريطة فقط.
 == مصادر ==
-* [https://sass-lang.com/documentation/Sass/Script/Functions.html#min-instance_method قسم الدالة min في صفحة الدوال في توثيق Sass الرسمي.]
+* [https://sass-lang.com/documentation/Sass/Script/Functions.html#map_get-instance_method قسم الدالة map_get في صفحة الدوال في توثيق Sass الرسمي].
-[[تصنيف:Sass]]
+[[تصنيف:Sass|{{SUBPAGENAME}}]]
-[[تصنيف: Sass Function]]
+[[تصنيف: Sass Function|{{SUBPAGENAME}}]]