الفرق بين المراجعتين ل"Sass/map remove"
< Sass
اذهب إلى التنقل
اذهب إلى البحث
ط (استبدال النص - 'توثيق Sass الرسمي.]' ب'توثيق Sass الرسمي].') |
|||
| (3 مراجعات متوسطة بواسطة مستخدمين اثنين آخرين غير معروضة) | |||
| سطر 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> [[Sass/SassScript#.D8.A7.D9.84.D8.AE.D8.B1.D8.A7.D8.A6.D8.B7 .28Maps.29|خريطة]] (map) جديدة بعد حذف مفاتيح معيّنة من الخريطة الممرَّرة إليها. |
| + | |||
| + | تُعيد الدالة <code>map_remove()</code> خريطة جديدة، مثل جميع دوال الخرائط، بدلًا من تعديل معاملاتها موضعيًا. | ||
== البنية العامة == | == البنية العامة == | ||
<syntaxhighlight lang="sass"> | <syntaxhighlight lang="sass"> | ||
| سطر 9: | سطر 11: | ||
=== <code>$map</code> === | === <code>$map</code> === | ||
| − | + | الخريطة المراد حذف مفاتيح محدَّدة منها. | |
=== <code>$keys</code> === | === <code>$keys</code> === | ||
| − | المفاتيح | + | المفاتيح المراد حذفها من الخريطة <code>$map</code>. |
== القيم المعادة == | == القيم المعادة == | ||
| − | + | تُعاد خريطة الخريطة <code>$map</code> بعد حذف المفاتيح <code>$keys</code> منها. | |
== الأخطاء والاستثناءات == | == الأخطاء والاستثناءات == | ||
| − | سيُرمى الخطأ <code>ArgumentError</code> إن | + | سيُرمى الخطأ <code>ArgumentError</code> إن لم يكن المعامل <code>$map</code> خريطةً. |
== أمثلة == | == أمثلة == | ||
| سطر 27: | سطر 29: | ||
</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>: تعيد قائمة تحتوي على قيم الخريطة فقط. |
| + | * الدالة <code>[[Sass/map has key|map_has_key()]]</code>: تتحقَّق إن كانت الخريطة الممرَّرة إليها تحتوي على مفتاح معيّن وهذا المفتاح مرتبط بقيمة ما. | ||
| + | * الدالة <code>[[Sass/map get|map_get()]]</code>: تعيد القيمة الموجودة في الخريطة والمرتبطة بالمفتاح المُعطى. | ||
== مصادر == | == مصادر == | ||
| − | * [https://sass-lang.com/documentation/Sass/Script/Functions.html#map_remove-instance_method قسم الدالة map_remove في صفحة الدوال في توثيق Sass الرسمي. | + | * [https://sass-lang.com/documentation/Sass/Script/Functions.html#map_remove-instance_method قسم الدالة map_remove في صفحة الدوال في توثيق Sass الرسمي]. |
| − | [[تصنيف:Sass]] | + | [[تصنيف:Sass|{{SUBPAGENAME}}]] |
| − | [[تصنيف: Sass Function]] | + | [[تصنيف: Sass Function|{{SUBPAGENAME}}]] |
المراجعة الحالية بتاريخ 07:00، 20 مايو 2018
تعيد الدالة map_remove() خريطة (map) جديدة بعد حذف مفاتيح معيّنة من الخريطة الممرَّرة إليها.
تُعيد الدالة map_remove() خريطة جديدة، مثل جميع دوال الخرائط، بدلًا من تعديل معاملاتها موضعيًا.
البنية العامة
map_remove($map, $keys...)
المعاملات
$map
الخريطة المراد حذف مفاتيح محدَّدة منها.
$keys
المفاتيح المراد حذفها من الخريطة $map.
القيم المعادة
تُعاد خريطة الخريطة $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(): تعيد قائمة تحتوي على قيم الخريطة فقط. - الدالة
map_has_key(): تتحقَّق إن كانت الخريطة الممرَّرة إليها تحتوي على مفتاح معيّن وهذا المفتاح مرتبط بقيمة ما. - الدالة
map_get(): تعيد القيمة الموجودة في الخريطة والمرتبطة بالمفتاح المُعطى.