الفرق بين المراجعتين لصفحة: «Sass/map remove»
< Sass
لا ملخص تعديل |
لا ملخص تعديل |
||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: الدالة <code>()map_remove</code> في Sass}}</noinclude> | <noinclude>{{DISPLAYTITLE: الدالة <code>()map_remove</code> في Sass}}</noinclude> | ||
تعيد الدالة <code>map_remove()</code> قاموسًا جديدًا بعد حذف | تعيد الدالة <code>map_remove()</code> قاموسًا جديدًا بعد حذف مفاتيح معيّنة منه. ومثل جميع دوال القواميس، فالدالة <code>map_remove()</code> تُعيد قاموسًا جديدًا بدلًا من تعديل معاملاتها موضعيًا. | ||
== البنية العامة == | == البنية العامة == | ||
<syntaxhighlight lang="sass"> | <syntaxhighlight lang="sass"> | ||
| سطر 11: | سطر 9: | ||
=== <code>$map</code> === | === <code>$map</code> === | ||
القاموس. | القاموس الذي نريد حذف بعض مفاتيحه. | ||
=== <code>$keys</code> === | === <code>$keys</code> === | ||
المفاتيح. | المفاتيح التي نريد حذفها من القاموس. | ||
== القيم المعادة == | == القيم المعادة == | ||
قاموسًا جديدًا بعد حذف المفاتيح. | تعيد هذه الدالة قاموسًا جديدًا بعد حذف المفاتيح. | ||
== الأخطاء والاستثناءات == | == الأخطاء والاستثناءات == | ||
| سطر 23: | سطر 21: | ||
== أمثلة == | == أمثلة == | ||
مثال عن استخدام الدالة <code>map_remove()</code>:<syntaxhighlight> | مثال عن استخدام الدالة <code>map_remove()</code>:<syntaxhighlight lang="sass"> | ||
map-remove(("foo": 1, "bar": 2), "bar") | map-remove(("foo": 1, "bar": 2), "bar") // ("foo": 1) | ||
map-remove(("foo": 1, "bar": 2, "baz": 3), "bar", "baz") | map-remove(("foo": 1, "bar": 2, "baz": 3), "bar", "baz") // ("foo": 1) | ||
map-remove(("foo": 1, "bar": 2), "baz") | map-remove(("foo": 1, "bar": 2), "baz") // ("foo": 1, "bar": 2) | ||
</syntaxhighlight> | </syntaxhighlight> | ||
== انظر أيضًا == | == انظر أيضًا == | ||
* الدالة <code>[[Sass/map merge|map_merge()]]</code>: تدمج قاموسين في قاموس واحدٍ. | * الدالة <code>[[Sass/map merge|map_merge()]]</code>: تدمج قاموسين في قاموس واحدٍ. | ||
* الدالة <code>[[Sass/map keys|map_keys()]]</code>: تُعيد قائمة مكونة من مفاتيح القاموس. | * الدالة <code>[[Sass/map keys|map_keys()]]</code>: تُعيد قائمة مكونة من مفاتيح القاموس. | ||
* الدالة <code>[[Sass/map values|map_values()]]</code>: تُعيد قائمة مكونة من قيم القاموس. | * الدالة <code>[[Sass/map values|map_values()]]</code>: تُعيد قائمة مكونة من قيم القاموس. | ||
مراجعة 02:52، 22 أبريل 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(): تُعيد قائمة مكونة من قيم القاموس.