الفرق بين المراجعتين لصفحة: «Sass/map has key»
< Sass
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>()map_has_key</code> في Sass}}</noinclude> تعيد الدالة <code>map_has_key()</code> قائمة مكونةً م...' |
ط استبدال النص - '\[\[تصنيف:(.*)\]\]' ب'{{SUBPAGENAME}}' |
||
(5 مراجعات متوسطة بواسطة 3 مستخدمين غير معروضة) | |||
سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: الدالة <code>()map_has_key</code> في Sass}}</noinclude> | <noinclude>{{DISPLAYTITLE: الدالة <code>()map_has_key</code> في Sass}}</noinclude> | ||
تتحقَّق الدالة <code>map_has_key()</code> إن كانت [[Sass/SassScript#.D8.A7.D9.84.D8.AE.D8.B1.D8.A7.D8.A6.D8.B7 .28Maps.29|الخريطة]] (map) الممرَّرة إليها تحتوي على مفتاح معيّن وهذا المفتاح مرتبط بقيمة ما. | |||
== البنية العامة == | == البنية العامة == | ||
<syntaxhighlight lang="sass"> | <syntaxhighlight lang="sass"> | ||
map_has_key($map) | map_has_key($map, $key) | ||
</syntaxhighlight> | </syntaxhighlight> | ||
سطر 9: | سطر 9: | ||
=== <code>$map</code> === | === <code>$map</code> === | ||
الخريطة المراد التحقٌّق من وجود قيمة مرتبطة بالمفتاح <code>$key</code> فيها. | |||
=== <code>$key</code> === | |||
المفتاح الذي سيُبحث عنه في الخريطة <code>$map</code>. | |||
== القيم المعادة == | == القيم المعادة == | ||
تُعاد القيمة <code>TRUE</code> إذا كان المفتاح موجودًا في الخريطة <code>$map</code> ومرتبطًا بقيمة ما، أو القيمة <code>FALSE</code> خلا ذلك. | |||
== الأخطاء والاستثناءات == | == الأخطاء والاستثناءات == | ||
سيُرمى الخطأ <code>ArgumentError</code> إن | سيُرمى الخطأ <code>ArgumentError</code> إن لم يكن المعامل <code>$map</code> خريطة. | ||
== أمثلة == | == أمثلة == | ||
مثال عن استخدام الدالة <code>map_has_key()</code>:<syntaxhighlight> | مثال عن استخدام الدالة <code>map_has_key()</code>:<syntaxhighlight lang="sass"> | ||
map- | map-has-key(("foo": 1, "bar": 2), "foo") // true | ||
map-has-key(("foo": 1, "bar": 2), "baz") // false | |||
</syntaxhighlight> | </syntaxhighlight> | ||
== انظر أيضًا == | == انظر أيضًا == | ||
* الدالة <code>[[Sass/map merge|map_merge()]]</code>: تدمج | * الدالة <code>[[Sass/map get|map_get()]]</code>: تعيد القيمة الموجودة في <nowiki/>[[Sass/SassScript#.D8.A7.D9.84.D8.AE.D8.B1.D8.A7.D8.A6.D8.B7 .28Maps.29|الخريطة]] (map) والمرتبطة بالمفتاح المُعطى. | ||
* الدالة <code>[[Sass/map merge|map_merge()]]</code>: تدمج خريطتين في خريطة واحدة. | |||
* الدالة <code>[[Sass/map remove|map_remove()]]</code>: | * الدالة <code>[[Sass/map remove|map_remove()]]</code>: تعيد خريطة بعد حذف مفاتيح محدَّدة منها. | ||
* الدالة <code>[[Sass/map values|map_values()]]</code>: | * الدالة <code>[[Sass/map values|map_values()]]</code>: تعيد قائمة تحتوي على قيم الخريطة فقط. | ||
== مصادر == | == مصادر == | ||
* [https://sass-lang.com/documentation/Sass/Script/Functions.html#map_has_key-instance_method قسم الدالة map_has_key في صفحة الدوال في توثيق Sass الرسمي. | * [https://sass-lang.com/documentation/Sass/Script/Functions.html#map_has_key-instance_method قسم الدالة map_has_key في صفحة الدوال في توثيق Sass الرسمي]. | ||
[[تصنيف:Sass]] | [[تصنيف:Sass|{{SUBPAGENAME}}]] | ||
[[تصنيف: Sass Function]] | [[تصنيف: Sass Function|{{SUBPAGENAME}}]] |
المراجعة الحالية بتاريخ 07:01، 20 مايو 2018
تتحقَّق الدالة map_has_key()
إن كانت الخريطة (map) الممرَّرة إليها تحتوي على مفتاح معيّن وهذا المفتاح مرتبط بقيمة ما.
البنية العامة
map_has_key($map, $key)
المعاملات
$map
الخريطة المراد التحقٌّق من وجود قيمة مرتبطة بالمفتاح $key
فيها.
$key
المفتاح الذي سيُبحث عنه في الخريطة $map
.
القيم المعادة
تُعاد القيمة TRUE
إذا كان المفتاح موجودًا في الخريطة $map
ومرتبطًا بقيمة ما، أو القيمة FALSE
خلا ذلك.
الأخطاء والاستثناءات
سيُرمى الخطأ ArgumentError
إن لم يكن المعامل $map
خريطة.
أمثلة
مثال عن استخدام الدالة map_has_key()
:
map-has-key(("foo": 1, "bar": 2), "foo") // true
map-has-key(("foo": 1, "bar": 2), "baz") // false
انظر أيضًا
- الدالة
map_get()
: تعيد القيمة الموجودة في الخريطة (map) والمرتبطة بالمفتاح المُعطى. - الدالة
map_merge()
: تدمج خريطتين في خريطة واحدة. - الدالة
map_remove()
: تعيد خريطة بعد حذف مفاتيح محدَّدة منها. - الدالة
map_values()
: تعيد قائمة تحتوي على قيم الخريطة فقط.