الفرق بين المراجعتين لصفحة: «Kotlin/collections/subtract»
< Kotlin | collections
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>subtract()</code> في لغة Kotlin}}</noinclude> تعيد الدالة<code>subtract()</code> Kotlin/List|لائ...' |
جميل-بيلوني (نقاش | مساهمات) طلا ملخص تعديل |
||
(4 مراجعات متوسطة بواسطة 3 مستخدمين غير معروضة) | |||
سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: الدالة <code>subtract()</code> في | <noinclude>{{DISPLAYTITLE: الدالة <code>subtract()</code> في Kotlin}}</noinclude> | ||
تستثني الدالة <code>subtract()</code> العناصر المشتركة بين كائنين. | |||
تحافظ [[Kotlin/Set|المجموعة]] (Set) المُعادة على ترتيب التكرار الخاص [[Kotlin/collections|بالمجموعة]] (collection) المعطاة. | |||
==البنية العامة== | ==البنية العامة== | ||
<nowiki/><nowiki/><syntaxhighlight lang="kotlin"> | يمكن استدعاء الدالة <code>subtract()</code> مع [[Kotlin/Array|المصفوفات]] و<nowiki/>[[Kotlin/Iterable|المجموعات التكرارية]]:<nowiki/><nowiki/><syntaxhighlight lang="kotlin"> | ||
fun <T> Array<out T>. | infix fun <T> Array<out T>.subtract( | ||
other: Iterable<T> | |||
): | ): Set<T> | ||
fun ByteArray. | infix fun ByteArray.subtract( | ||
other: Iterable<Byte> | |||
): | ): Set<Byte> | ||
fun ShortArray. | infix fun ShortArray.subtract( | ||
other: Iterable<Short> | |||
): | ): Set<Short> | ||
fun IntArray. | infix fun IntArray.subtract(other: Iterable<Int>): Set<Int> | ||
infix fun LongArray.subtract( | |||
): | other: Iterable<Long> | ||
fun LongArray. | ): Set<Long> | ||
infix fun FloatArray.subtract( | |||
): | other: Iterable<Float> | ||
fun FloatArray. | ): Set<Float> | ||
infix fun DoubleArray.subtract( | |||
): | other: Iterable<Double> | ||
fun DoubleArray. | ): Set<Double> | ||
infix fun BooleanArray.subtract( | |||
): | other: Iterable<Boolean> | ||
fun BooleanArray. | ): Set<Boolean> | ||
infix fun CharArray.subtract( | |||
): | other: Iterable<Char> | ||
fun CharArray. | ): Set<Char> | ||
): | infix fun <T> Iterable<T>.subtract( | ||
fun <T> Iterable<T>. | other: Iterable<T> | ||
): Set<T> | |||
): | |||
</syntaxhighlight> | </syntaxhighlight> | ||
== القيمة | == المعاملات == | ||
[[Kotlin/ | |||
=== <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>) { | fun main(args: Array<String>) { | ||
val array = arrayOf( | val array = arrayOf(3, 5, 7, 2 , 6, 9) | ||
val list = listOf(3, 9, 1) | |||
println(array.subtract(list))// [5, 7, 2, 6] | |||
} | } | ||
</syntaxhighlight> | </syntaxhighlight> | ||
== | ==انظر أيضًا== | ||
*<code>[[Kotlin/collections/ | * الدالة <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/ | * الدالة <code>[[Kotlin/collections/slice|slice()]]</code> : تقطع جزءًا محدَّدًا من <nowiki/>[[Kotlin/Array|المصفوفة]] أو القائمة التي استُدعيت معها ثمَّ تعيده في قائمة. | ||
* <code>[[Kotlin/collections/ | * الدالة <code>[[Kotlin/collections/sum|sum()]]</code>: تجمع جميع قيم عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت معها ثمَّ تعيد الناتج. | ||
* <code>[[Kotlin/collections/ | * الدالة <code>[[Kotlin/collections/sort|sort()]]</code> : ترتب <nowiki/>[[Kotlin/Array|المصفوفة]] أو القائمة المتغيرة (MutableList) التي استُدعيت معها تصاعديًّا. | ||
==مصادر== | ==مصادر== | ||
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/ | *[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/subtract.html صفحة الدالة subtract() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] | ||
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
[[تصنيف:Kotlin | [[تصنيف:Kotlin Function]] | ||
[[تصنيف:Kotlin Collection]] |
المراجعة الحالية بتاريخ 11:21، 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>
المعاملات
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) التي استُدعيت معها تصاعديًّا.