عرض مصدر Kotlin/collections/contains

<noinclude>{{DISPLAYTITLE: الدالة <code>contains()‎</code> في Kotlin}}</noinclude>
تتحقق الدالة <code>contains()‎</code> إن كانت [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت معها تحتوي على العنصر الممرّر إليها، أو إن كانت الخريطة التي استدعيت معها تحتوي على ذلك العنصر كمفتاح (key).  

يمكن استدعاء <code>contains()‎</code> مع خريطة بالشكل <code>x in map</code> للتحقق من أنّ العنصر <code>x</code> موجود ضمنها. 
==البنية العامة==
يمكن استدعاء الدالة <code>contains()‎</code> مع [[Kotlin/Array|مصفوفات]]:<syntaxhighlight lang="kotlin">
operator fun <T> Array<out T>.contains(element: T): Boolean 
operator fun ByteArray.contains(element: Byte): Boolean 
operator fun ShortArray.contains(element: Short): Boolean 
operator fun IntArray.contains(element: Int): Boolean 
operator fun LongArray.contains(element: Long): Boolean 
operator fun FloatArray.contains(element: Float): Boolean 
operator fun DoubleArray.contains(element: Double): Boolean 
operator fun BooleanArray.contains(element: Boolean): Boolean 
operator fun CharArray.contains(element: Char): Boolean
</syntaxhighlight>

ومع [[Kotlin/collections|مجموعات]]:<syntaxhighlight lang="kotlin">
operator fun <T> Iterable<T>.contains(element: T): Boolean 

</syntaxhighlight>ومع خرائط (maps) أيضًا:<syntaxhighlight lang="kotlin">
inline operator fun <K, V> Map<out K, V>.contains(
    key: K
): Boolean
</syntaxhighlight>وجود الكلمة المفتاحية <code>inline</code> يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]])، ووجود الكلمة المفتاحية <code>operator</code> يدل على أنّ هذه الدالة مرتبط بمعامل الفهرسة المذكور سابقًا.
==القيم المعادة==
تُعاد القيمة المنطقيَّة <code>true</code> إن كانت [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت الدالة معها تحتوي على العنصر الممرّر إليها، أو إن كانت الخريطة التي استدعيت معها تحتوي على ذلك العنصر كمفتاح (key). خلا ذلك، تعيد القيمة <code>false</code>. 
==أمثلة==
===استخدام الدالة <code>()contains</code> مع القوائم ===
تعرِّف الشيفرة الآتية قائمةً باسم <code>list</code> مكونة من خمسة حروف باستخدام الدالة <code>()listOf</code> ثم تستخدم الدالة <code>()contains</code> للتحقق من أنّ الحرفين <code>'d'</code> و <code>'x'</code> موجودان في تلك القائمة وتطبع الناتج:<syntaxhighlight lang="kotlin">
fun main(args: Array<String>) {
    val list = listOf('a', 'b', 'c', 'd', 'e')

    println(list.contains('d')) // true
    println(list.contains('x')) // false
}
</syntaxhighlight>

===استخدام الدالة <code>()contains</code> مع الخرائط ===
تعرِّف الشيفرة الآتية خريطةً باسم <code>map</code> مكونة من زوجين باستخدام الدالة <code>()hashMapOf</code> ثمَّ تستخدم الدالة <code>()contains</code> للتحقق من أنّ السلسلتين النصيتين <code>'foo'</code> و <code>'bat'</code> موجودتان في المفاتيح (key) ضمن تلك الخريطة:<syntaxhighlight lang="kotlin">
fun main(args: Array<String>) {
    val map = hashMapOf("foo" to 1, "bar" to 2)

    println(map.contains("foo")) // true
    println(map.contains("bat")) // false
}
</syntaxhighlight>
==انظر أيضًا==
*الدالة <code>[[Kotlin/collections/component1|component1()‎]]</code>: تعيد العنصر الأول من المصفوفة أو المفتاح (key) لأول زوج (مفتاح/قيمة) في الخريطة (map) التي استدعيت معها. 
*الدالة <code>[[Kotlin/collections/associate|associate()]]</code>‎: تعيد خريطةً (map) تحوي أزواجًا من "مفتاح/قيمة" ناتجة عن تمرير عناصر مصفوفة أو مجموعة ([[Kotlin/collections|Collection]]) إلى الدالة <code>()transform</code>.
* الدالة <code>[[Kotlin/collections/asList|asList()]]</code>‎: تعيد قائمة تُغلّف المصفوفة الأصليَّة.
* الخاصيّة <code>[[Kotlin/Array/size|Array.size]]</code>: تمثِّل عدد العناصر الموجودة في المصفوفة.

==مصادر==
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/contains.html صفحة الدالة contains()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Functions]]