Kotlin/collections/subtract

تستثني الدالة subtract()‎ العناصر المشتركة بين كائنين.

تحافظ المجموعة (Set) المُعادة على ترتيب التكرار الخاص بالمجموعة (collection) المعطاة.

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

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

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

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

المعاملات

other

الكائن الآخر الذي ستطبق عليه العملية.

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

تُعاد مجموعة (Set) تضم جميع العناصر الموجودة في المصفوفة أو المجموعة التكرارية المعطاة والغير موجودة في المعامل other المعطى.

أمثلة

استعمال الدالة ()subtract لاستثناء العناصر المشتركة بين كائنين:

fun main(args: Array<String>) {
    val array = arrayOf(3, 5, 7, 2 , 6, 9)
    val list = listOf(3, 9, 1)

    println(array.subtract(list))// [5, 7, 2, 6]
}

انظر أيضًا

• الدالة union()‎: تجمع العناصر المشتركة وغير المتشركة بين المصفوفة أو المجموعة التكرارية التي استُدعيت معها وبين المجموعة التكرارية المُمرّرة إليها في مجموعةٍ واحدةٍ من النوع Set بعد حذف العناصر المتكررة.
• الدالة plusElement()‎: تضيف العنصر المُمرّر إليها إلى المصفوفة أو المجموعة التي استُدعيت معها.
• الدالة slice()‎ : تقطع جزءًا محدَّدًا من المصفوفة أو القائمة التي استُدعيت معها ثمَّ تعيده في قائمة.
• الدالة sum()‎: تجمع جميع قيم عناصر المصفوفة أو المجموعة التي استُدعيت معها ثمَّ تعيد الناتج.
• الدالة sort()‎ : ترتب المصفوفة أو القائمة المتغيرة (MutableList) التي استُدعيت معها تصاعديًّا.

مصادر

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