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

مراجعة 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()‎: تُعيد قائمة مكونة من قيم القاموس.

مصادر

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

@@ سطر 1: / سطر 1: @@
 <noinclude>{{DISPLAYTITLE: الدالة <code>()map_get</code> في Sass}}</noinclude>
-تعيد الدالة <code>map_get()‎</code> القيمة الأصغر بين مجموعة من الأعداد.
+تعيد الدالة <code>map_get()‎</code> القيمة المرتبطة بالمفتاح المُعطى. إن لم يتضمّن القاموس ذلك المفتاح فستعيد الدالة القيمة المعدومة <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>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>
-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 Function]]