عرض مصدر Kotlin/collections/subtract

<noinclude>{{DISPLAYTITLE: الدالة <code>subtract()‎</code> في Kotlin}}</noinclude>
تستثني الدالة <code>subtract()‎</code> العناصر المشتركة بين كائنين. 

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

==البنية العامة==
يمكن استدعاء الدالة <code>subtract()‎</code> مع [[Kotlin/Array|المصفوفات]] و<nowiki/>[[Kotlin/Iterable|المجموعات التكرارية]]:<nowiki/><nowiki/><syntaxhighlight lang="kotlin">
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> 
</syntaxhighlight>

== المعاملات ==

=== <code>other</code> ===
الكائن الآخر الذي ستطبق عليه العملية.

== القيمة المعادة ==
تُعاد [[Kotlin/Set|مجموعة]] (Set) تضم جميع العناصر الموجودة في [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Iterable|المجموعة التكرارية]] المعطاة والغير موجودة في المعامل <code>other</code> المعطى.

==أمثلة==
<nowiki/><nowiki/><nowiki/>استعمال الدالة <code>()subtract</code> لاستثناء العناصر المشتركة بين كائنين:<syntaxhighlight lang="kotlin">
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]
}
</syntaxhighlight>
==انظر أيضًا==
* الدالة <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) التي استُدعيت معها تصاعديًّا.

==مصادر==
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/subtract.html صفحة الدالة subtract()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Function]]
[[تصنيف:Kotlin Collection]]