الفرق بين المراجعتين ل"Sass/map remove"

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>()map_remove</code> في Sass}}</noinclude> تعيد الدالة <code>map_remove()‎</code> القيمة المرتبط...')
 
سطر 1: سطر 1:
 
<noinclude>{{DISPLAYTITLE: الدالة <code>()map_remove</code> في Sass}}</noinclude>
 
<noinclude>{{DISPLAYTITLE: الدالة <code>()map_remove</code> في Sass}}</noinclude>
تعيد الدالة <code>map_remove()‎</code> القيمة المرتبطة بالمفتاح المُعطى. إن لم يتضمّن القاموس ذلك المفتاح فستعيد الدالة القيمة المعدومة <code>null</code>.
+
تعيد الدالة <code>map_remove()‎</code> قاموسًا جديدًا بعد حذف المفاتيح.
 +
 
 +
مثل جميع دوال القواميس، فالدالة <code>map_remove()‎</code> تُعيد قاموسًا جديدًا بدلًا من تعديل معاملاتها موضعيًا.
 
== البنية العامة ==
 
== البنية العامة ==
 
<syntaxhighlight lang="sass">
 
<syntaxhighlight lang="sass">
map_remove($map, $key)
+
map_remove($map, $keys...)
 
</syntaxhighlight>
 
</syntaxhighlight>
  
سطر 11: سطر 13:
 
القاموس.
 
القاموس.
  
=== <code>‎$key</code> ===
+
=== <code>‎$keys</code> ===
المفتاح.
+
المفاتيح.
  
 
== القيم المعادة ==
 
== القيم المعادة ==
القيمة المُفهرسة بالمفتاح <code>‎$key</code>، أو القيمة المعدومة <code>null</code> إن لم يتضمّن القاموس المفتاح المحدد
+
قاموسًا جديدًا بعد حذف المفاتيح.
  
 
== الأخطاء والاستثناءات ==
 
== الأخطاء والاستثناءات ==
سيُرمى الخطأ <code>ArgumentError</code> إن كان لم يكن المعامل <code>‎$map</code> مفتاحًا.
+
سيُرمى الخطأ <code>ArgumentError</code> إن كان لم يكن المعامل <code>‎$map</code> قاموسًا.
  
 
== أمثلة ==
 
== أمثلة ==
 
مثال عن استخدام الدالة <code>map_remove()‎</code>:<syntaxhighlight>
 
مثال عن استخدام الدالة <code>map_remove()‎</code>:<syntaxhighlight>
map-get(("foo": 1, "bar": 2), "foo") => 1
+
map-remove(("foo": 1, "bar": 2), "bar") => ("foo": 1)
map-get(("foo": 1, "bar": 2), "bar") => 2
+
map-remove(("foo": 1, "bar": 2, "baz": 3), "bar", "baz") => ("foo": 1)
map-get(("foo": 1, "bar": 2), "baz") => null
+
map-remove(("foo": 1, "bar": 2), "baz") => ("foo": 1, "bar": 2)
 
</syntaxhighlight>
 
</syntaxhighlight>
 
== انظر أيضًا ==
 
== انظر أيضًا ==
 
* الدالة <code>[[Sass/round|map_merge()]]</code>‎: تدمج قاموسين في قاموس واحدٍ.
 
* الدالة <code>[[Sass/round|map_merge()]]</code>‎: تدمج قاموسين في قاموس واحدٍ.
* الدالة <code>[[Sass/map remove|map_remove()]]</code>‎: تُغيد قاموسًا جديدًا مع حذف المفاتيح.
 
  
 
* الدالة <code>[[Sass/map keys|map_keys()]]</code>‎: تُعيد قائمة مكونة من مفاتيح القاموس.
 
* الدالة <code>[[Sass/map keys|map_keys()]]</code>‎: تُعيد قائمة مكونة من مفاتيح القاموس.

مراجعة 15:14، 21 أبريل 2018

تعيد الدالة map_remove()‎ قاموسًا جديدًا بعد حذف المفاتيح.

مثل جميع دوال القواميس، فالدالة map_remove()‎ تُعيد قاموسًا جديدًا بدلًا من تعديل معاملاتها موضعيًا.

البنية العامة

map_remove($map, $keys...)

المعاملات

‎$map

القاموس.

‎$keys

المفاتيح.

القيم المعادة

قاموسًا جديدًا بعد حذف المفاتيح.

الأخطاء والاستثناءات

سيُرمى الخطأ ArgumentError إن كان لم يكن المعامل ‎$map قاموسًا.

أمثلة

مثال عن استخدام الدالة map_remove()‎:

map-remove(("foo": 1, "bar": 2), "bar") => ("foo": 1)
map-remove(("foo": 1, "bar": 2, "baz": 3), "bar", "baz") => ("foo": 1)
map-remove(("foo": 1, "bar": 2), "baz") => ("foo": 1, "bar": 2)

انظر أيضًا

  • الدالة map_merge()‎: تدمج قاموسين في قاموس واحدٍ.
  • الدالة map_keys()‎: تُعيد قائمة مكونة من مفاتيح القاموس.
  • الدالة map_values()‎: تُعيد قائمة مكونة من قيم القاموس.

مصادر