الفرق بين المراجعتين لصفحة: «Kotlin/collections/contains»
< Kotlin | collections
جميل-بيلوني (نقاش | مساهمات) ط تدقيق الأمثلة. |
جميل-بيلوني (نقاش | مساهمات) طلا ملخص تعديل |
||
| (3 مراجعات متوسطة بواسطة مستخدمين اثنين آخرين غير معروضة) | |||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: الدالة <code>contains()</code> في | <noinclude>{{DISPLAYTITLE: الدالة <code>contains()</code> في Kotlin}}</noinclude> | ||
تتحقق الدالة <code>contains()</code> إن كانت [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت معها تحتوي على العنصر الممرّر إليها، أو إن كانت الخريطة التي استدعيت معها تحتوي على ذلك العنصر كمفتاح (key). | تتحقق الدالة <code>contains()</code> إن كانت [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت معها تحتوي على العنصر الممرّر إليها، أو إن كانت الخريطة التي استدعيت معها تحتوي على ذلك العنصر كمفتاح (key). | ||
| سطر 24: | سطر 24: | ||
): Boolean | ): Boolean | ||
</syntaxhighlight>وجود الكلمة المفتاحية <code>inline</code> يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]])، ووجود الكلمة المفتاحية <code>operator</code> يدل على أنّ هذه الدالة مرتبط بمعامل الفهرسة المذكور سابقًا. | </syntaxhighlight>وجود الكلمة المفتاحية <code>inline</code> يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]])، ووجود الكلمة المفتاحية <code>operator</code> يدل على أنّ هذه الدالة مرتبط بمعامل الفهرسة المذكور سابقًا. | ||
== المعاملات == | |||
=== <code>element</code> === | |||
العنصر المراد التحقق من وجوده ضمن [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] المعطاة. | |||
==القيم المعادة== | ==القيم المعادة== | ||
تُعاد القيمة المنطقيَّة <code>true</code> إن كانت [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت الدالة معها تحتوي على العنصر الممرّر إليها، أو إن كانت الخريطة التي استدعيت معها تحتوي على ذلك العنصر كمفتاح (key). خلا ذلك، تعيد القيمة <code>false</code>. | تُعاد القيمة المنطقيَّة <code>true</code> إن كانت [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت الدالة معها تحتوي على العنصر الممرّر إليها، أو إن كانت الخريطة التي استدعيت معها تحتوي على ذلك العنصر كمفتاح (key). خلا ذلك، تعيد القيمة <code>false</code>. | ||
==أمثلة== | ==أمثلة== | ||
استخدام الدالة <code>()contains</code> مع القوائم:<syntaxhighlight lang="kotlin"> | |||
fun main(args: Array<String>) { | fun main(args: Array<String>) { | ||
val list = listOf('a', 'b', 'c', 'd', 'e') | val list = listOf('a', 'b', 'c', 'd', 'e') | ||
| سطر 35: | سطر 40: | ||
println(list.contains('x')) // false | println(list.contains('x')) // false | ||
} | } | ||
</syntaxhighlight> | </syntaxhighlight>استخدام الدالة <code>()contains</code> مع الخرائط:<syntaxhighlight lang="kotlin"> | ||
fun main(args: Array<String>) { | fun main(args: Array<String>) { | ||
val map = hashMapOf("foo" to 1, "bar" to 2) | val map = hashMapOf("foo" to 1, "bar" to 2) | ||
| سطر 53: | سطر 55: | ||
==مصادر== | ==مصادر== | ||
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/contains.html الدالة contains() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] | *[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/contains.html صفحة الدالة contains() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] | ||
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
[[تصنيف:Kotlin | [[تصنيف:Kotlin Function]] | ||
[[تصنيف:Kotlin Collection]] | |||
المراجعة الحالية بتاريخ 07:27، 8 سبتمبر 2018
تتحقق الدالة contains() إن كانت المصفوفة أو المجموعة التي استُدعيت معها تحتوي على العنصر الممرّر إليها، أو إن كانت الخريطة التي استدعيت معها تحتوي على ذلك العنصر كمفتاح (key).
يمكن استدعاء contains() مع خريطة بالشكل x in map للتحقق من أنّ العنصر x موجود ضمنها.
البنية العامة
يمكن استدعاء الدالة contains() مع مصفوفات:
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
ومع مجموعات:
operator fun <T> Iterable<T>.contains(element: T): Boolean
ومع خرائط (maps) أيضًا:
inline operator fun <K, V> Map<out K, V>.contains(
key: K
): Boolean
وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل راجع توثيق الدوال المباشرة (inline functions))، ووجود الكلمة المفتاحية operator يدل على أنّ هذه الدالة مرتبط بمعامل الفهرسة المذكور سابقًا.
المعاملات
element
العنصر المراد التحقق من وجوده ضمن المصفوفة أو المجموعة المعطاة.
القيم المعادة
تُعاد القيمة المنطقيَّة true إن كانت المصفوفة أو المجموعة التي استُدعيت الدالة معها تحتوي على العنصر الممرّر إليها، أو إن كانت الخريطة التي استدعيت معها تحتوي على ذلك العنصر كمفتاح (key). خلا ذلك، تعيد القيمة false.
أمثلة
استخدام الدالة ()contains مع القوائم:
fun main(args: Array<String>) {
val list = listOf('a', 'b', 'c', 'd', 'e')
println(list.contains('d')) // true
println(list.contains('x')) // false
}
استخدام الدالة ()contains مع الخرائط:
fun main(args: Array<String>) {
val map = hashMapOf("foo" to 1, "bar" to 2)
println(map.contains("foo")) // true
println(map.contains("bat")) // false
}
انظر أيضًا
- الدالة
component1(): تعيد العنصر الأول من المصفوفة أو المفتاح (key) لأول زوج (مفتاح/قيمة) في الخريطة (map) التي استدعيت معها. - الدالة
associate(): تعيد خريطةً (map) تحوي أزواجًا من "مفتاح/قيمة" ناتجة عن تمرير عناصر مصفوفة أو مجموعة (Collection) إلى الدالة()transform. - الدالة
asList(): تعيد قائمة تُغلّف المصفوفة الأصليَّة. - الخاصيّة
Array.size: تمثِّل عدد العناصر الموجودة في المصفوفة.