Kotlin/collections/union

تجمع الدالة union()‎ العناصر المشتركة وغير المتشركة بين المصفوفة أو المجموعة التكرارية التي استُدعيت معها وبين المجموعة التكرارية المُمرّرة إليها في مجموعةٍ واحدةٍ من النوع Set بعد حذف العناصر المتكررة.

تحافظ المجموعة المُعادة على نفس ترتيب تكرار المصفوفة أو المجموعة التكرارية الأصلية. تضاف عناصر المجموعة التكرارية الممرَّرة إلى الدالة وغير المتكررة في النهاية.

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

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

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

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

المعاملات

other

المجموعة التكرارية الأخرى التي ستطبق عليها العملية.

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

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

أمثلة

استعمال الدالة ()union لجمع العناصر المشتركة وغير المتشركة بين مصفوفة وقائمة مع حذف العناصر المتكررة:

fun main(args: Array<String>) {
    val array = arrayOf(4, 5, 6, 4, 1, 6)
    val mutableList = mutableListOf(1, 2, 3)

    println(array.union(mutableList)) // [4, 5, 6, 1, 2, 3]
}

انظر أيضًا

• الدالة subtract()‎: تستثني العناصر المشتركة بين كائنين.
• الدالة sum()‎: تجمع جميع قيم عناصر المصفوفة أو المجموعة التي استُدعيت معها ثمَّ تعيد الناتج.
• الدالة plusElement()‎: تضيف العنصر المُمرّر إليها إلى المصفوفة أو المجموعة التي استُدعيت معها.

مصادر

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