الفرق بين المراجعتين لصفحة: «Kotlin/collections/subtract»

مراجعة 14:28، 9 أغسطس 2018

تستثني الدالة 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>

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

تُعاد مجموعة (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.

@@ سطر 49: / سطر 49: @@
 </syntaxhighlight>
 ==انظر أيضًا==
-* الدالة <code>[[Kotlin/collections/sort|sort()]]</code>‎ : ترتب <nowiki/>[[Kotlin/Array|المصفوفة]] أو القائمة المتغيرة (MutableList) التي استُدعيت معها تصاعديًّا.
+* الدالة <code>[[Kotlin/collections/union|union()‎]]</code>: تجمع العناصر المشتركة وغير المتشركة بين [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Iterable|المجموعة التكرارية]] التي استُدعيت معها وبين [[Kotlin/Iterable|المجموعة التكرارية]] المُمرّرة إليها في مجموعةٍ واحدةٍ من النوع <code>[[Kotlin/Set|Set]]</code> بعد حذف العناصر المتكررة.
 * الدالة <code>[[Kotlin/collections/plusElement|plusElement()‎]]</code>: تضيف العنصر المُمرّر إليها إلى <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها.
 * الدالة <code>[[Kotlin/collections/slice|slice()]]</code>‎ : تقطع جزءًا محدَّدًا من <nowiki/>[[Kotlin/Array|المصفوفة]] أو القائمة التي استُدعيت معها ثمَّ تعيده في قائمة.
 * الدالة <code>[[Kotlin/collections/sum|sum()]]</code>‎: تجمع جميع قيم عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت معها ثمَّ تعيد الناتج.
+* الدالة <code>[[Kotlin/collections/sort|sort()]]</code>‎ : ترتب <nowiki/>[[Kotlin/Array|المصفوفة]] أو القائمة المتغيرة (MutableList) التي استُدعيت معها تصاعديًّا.
 ==مصادر==