الفرق بين المراجعتين ل"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()
: تجمع جميع قيم عناصر المصفوفة أو المجموعة التي استُدعيت معها ثمَّ تعيد الناتج.