Kotlin/collections/intersect

تبحث الدالة intersect()‎ عن العناصر المشتركة بين مصفوفتين أو مجموعتين ثمَّ تعيدها في مجموعة.

تحافظ المجموعة المُعادة على ترتيب تكرار المصفوفة أو المجموعة الأصلية.

البنية العامة

يمكن استدعاء الدالة intersect()‎ مع المصفوفات والمجموعات:

infix fun <T> Array<out T>.intersect(
    other: Iterable<T>
): Set<T> 
infix fun ByteArray.intersect(
    other: Iterable<Byte>
): Set<Byte> 
infix fun ShortArray.intersect(
    other: Iterable<Short>
): Set<Short> 
infix fun IntArray.intersect(other: Iterable<Int>): Set<Int> (source)
infix fun LongArray.intersect(
    other: Iterable<Long>
): Set<Long> 
infix fun FloatArray.intersect(
    other: Iterable<Float>
): Set<Float> 
infix fun DoubleArray.intersect(
    other: Iterable<Double>
): Set<Double> 
infix fun BooleanArray.intersect(
    other: Iterable<Boolean>
): Set<Boolean> 
infix fun CharArray.intersect(
    other: Iterable<Char>
): Set<Char> 

infix fun <T> Iterable<T>.intersect(
    other: Iterable<T>
): Set<T>

وجود الكلمة المفتاحية infix يدل على أنَّ هذه الدالة يمكن استدعاؤها بنمط التدوين الداخليّ (infix notation)؛ أي من خلال حذف المعامل . والأقواس () المُستخدَمَين في الاستدعاء عادةً (راجع للمزيد من التفاصيل توثيق التدوين الداخلي للدوال (infix functions)).

المعاملات

other

كائن من النوع Iterable يراد البحث ضمنه عن عناصر مشتركة بينه وبين المصفوفة أو المجموعة المعطاة.

القيم المعادة

تُعاد مجموعة تحوي جميع العناصر المشتركة بين المصفوفتين أو المجموعتين المُعطَيتين.

أمثلة

مثالٌ على استعمال الدالة ()intersect:

fun main(args: Array<String>) {
    val iterable = listOf(1, 2, 3, 4, 5)
    val other1 = listOf(2, 3, 5, 2)
    val other2 = listOf(7, 8, 45, 67)

    val result1: Set<Int> = iterable.intersect(other1)
    println(result1) // [2, 3, 5]

    val result2: Set<Int> = iterable.intersect(other2)
    println(result2) // []
}

انظر أيضًا

• الدالة count()‎: تعيد عدد عناصر المصفوفة أو المجموعة أو الخريطة التي استُدعيت معها. يمكن تمرير دالة منطقية كمعامل إلى هذه الدالة لعد العناصر التي تحقق شرطًا معينًّا.
• الدالة fill()‎: تبدِّل قيمة جديدة معطاة مكان عناصر محدَّدة في المصفوفة أو القائمة التي تستدعى معها.
• الدالة contentDeepEquals()‎: تتحقق من تساوي مصفوفتين بالعُمق، أي أنَّهما تحتويان على نفس العناصر وبنفس الترتيب.
• الدالة indexOf()‎: تجلب فهرس أول ظهور لعنصر محدَّد من المصفوفة أو المجموعة أو القائمة التي استُدعيت معها.

مصادر

• صفحة الدالة intersect()‎ في التوثيق الرسمي للمكتبة القياسية في لغة Kotlin.