الفرق بين المراجعتين لصفحة: «Kotlin/collections/subtract»
< Kotlin | collections
لا ملخص تعديل |
جميل-بيلوني (نقاش | مساهمات) ط مراجعة وتدقيق. |
||
سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: الدالة <code>subtract()</code> في | <noinclude>{{DISPLAYTITLE: الدالة <code>subtract()</code> في Kotlin}}</noinclude> | ||
تستثني الدالة <code>subtract()</code> العناصر المشتركة بين كائنين. | |||
[[Kotlin/Set|المجموعة]] ( | تحافظ [[Kotlin/Set|المجموعة]] (Set) المُعادة على ترتيب التكرار الخاص [[Kotlin/collections|بالمجموعة]] (collection) المعطاة. | ||
==البنية العامة== | ==البنية العامة== | ||
يمكن استدعاء الدالة<code>subtract()</code> | يمكن استدعاء الدالة <code>subtract()</code> مع [[Kotlin/Array|المصفوفات]] و<nowiki/>[[Kotlin/Iterable|المجموعات التكرارية]]:<nowiki/><nowiki/><syntaxhighlight lang="kotlin"> | ||
infix fun <T> Array<out T>.subtract( | infix fun <T> Array<out T>.subtract( | ||
other: Iterable<T> | other: Iterable<T> | ||
سطر 32: | سطر 32: | ||
): Set<Char> | ): Set<Char> | ||
infix fun <T> Iterable<T>.subtract( | infix fun <T> Iterable<T>.subtract( | ||
other: Iterable<T> | other: Iterable<T> | ||
): Set<T> | ): Set<T> | ||
</syntaxhighlight> | </syntaxhighlight> | ||
== القيمة المعادة == | |||
== القيمة | تُعاد [[Kotlin/Set|مجموعة]] (Set) تضم جميع العناصر الموجودة في [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Iterable|المجموعة التكرارية]] المعطاة والغير موجودة في الوسيط <code>other</code> المعطى. | ||
[[Kotlin/Set|مجموعة]] ( | |||
==أمثلة== | ==أمثلة== | ||
<nowiki/><nowiki/><nowiki/>استعمال الدالة <code>()subtract</code> لاستثناء العناصر المشتركة بين كائنين:<syntaxhighlight lang="kotlin"> | |||
fun main(args: Array<String>) { | fun main(args: Array<String>) { | ||
val array = arrayOf(3, 5, 7, 2 , 6, 9) | val array = arrayOf(3, 5, 7, 2 , 6, 9) | ||
val list = listOf(3, 9, 1) | val list = listOf(3, 9, 1) | ||
println(array.subtract(list))// [5, 7, 2, 6] | println(array.subtract(list))// [5, 7, 2, 6] | ||
} | } | ||
</syntaxhighlight> | </syntaxhighlight> | ||
== | ==انظر أيضًا== | ||
* <code>[[Kotlin/collections/sort|sort()]]</code> : | * الدالة <code>[[Kotlin/collections/sort|sort()]]</code> : ترتب <nowiki/>[[Kotlin/Array|المصفوفة]] أو القائمة المتغيرة (MutableList) التي استُدعيت معها تصاعديًّا. | ||
* الدالة <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|المجموعة]] التي استُدعيت معها ثمَّ تعيد الناتج. | |||
==مصادر== | ==مصادر== | ||
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/subtract.html الدالة | *[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/subtract.html صفحة الدالة subtract() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] | ||
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
[[تصنيف:Kotlin Functions]] | [[تصنيف:Kotlin Functions]] |
مراجعة 14:39، 8 أغسطس 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]
}
انظر أيضًا
- الدالة
sort()
: ترتب المصفوفة أو القائمة المتغيرة (MutableList) التي استُدعيت معها تصاعديًّا. - الدالة
plusElement()
: تضيف العنصر المُمرّر إليها إلى المصفوفة أو المجموعة التي استُدعيت معها. - الدالة
slice()
: تقطع جزءًا محدَّدًا من المصفوفة أو القائمة التي استُدعيت معها ثمَّ تعيده في قائمة. - الدالة
sum()
: تجمع جميع قيم عناصر المصفوفة أو المجموعة التي استُدعيت معها ثمَّ تعيد الناتج.