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

من موسوعة حسوب
أنشأ الصفحة ب'<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> قائمة مكونةً من مفاتيح القاموس.
تتحقَّق الدالة <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>‎$map</code> قاموسًا.
سيُرمى الخطأ <code>ArgumentError</code> إن لم يكن المعامل <code>‎$map</code> خريطة.


== أمثلة ==
== أمثلة ==
مثال عن استخدام الدالة <code>map_has_key()‎</code>:<syntaxhighlight>
مثال عن استخدام الدالة <code>map_has_key()‎</code>:<syntaxhighlight lang="sass">
map-keys(("foo": 1, "bar": 2)) => "foo", "bar"
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()‎: تعيد قائمة تحتوي على قيم الخريطة فقط.

مصادر