الفرق بين المراجعتين ل"Kotlin/collections/union"
< Kotlin | collections
اذهب إلى التنقل
اذهب إلى البحث
جميل-بيلوني (نقاش | مساهمات) ط |
|||
| (مراجعتان متوسطتان بواسطة مستخدمين اثنين آخرين غير معروضتين) | |||
| سطر 1: | سطر 1: | ||
| − | <noinclude>{{DISPLAYTITLE: الدالة <code>union()</code> في | + | <noinclude>{{DISPLAYTITLE: الدالة <code>union()</code> في Kotlin}}</noinclude> |
| − | + | <nowiki/>تجمع الدالة <code>union()</code> العناصر المشتركة وغير المتشركة بين [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Iterable|المجموعة التكرارية]] التي استُدعيت معها وبين [[Kotlin/Iterable|المجموعة التكرارية]] المُمرّرة إليها في مجموعةٍ واحدةٍ من النوع <code>[[Kotlin/collections/Set|Set]]</code> بعد حذف العناصر المتكررة. | |
| − | تحافظ المجموعة المُعادة على ترتيب | + | تحافظ المجموعة المُعادة على نفس ترتيب تكرار [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Iterable|المجموعة التكرارية]] الأصلية. تضاف عناصر [[Kotlin/Iterable|المجموعة التكرارية]] الممرَّرة إلى الدالة وغير المتكررة في النهاية. |
==البنية العامة== | ==البنية العامة== | ||
| − | يمكن استدعاء الدالة<code>union()</code> | + | يمكن استدعاء الدالة<code>union()</code> مع [[Kotlin/Array|المصفوفات]] و<nowiki/>[[Kotlin/Iterable|المجموعات التكرارية]]:<syntaxhighlight lang="kotlin"> |
infix fun <T> Array<out T>.union(other: Iterable<T>): Set<T> | infix fun <T> Array<out T>.union(other: Iterable<T>): Set<T> | ||
infix fun ByteArray.union(other: Iterable<Byte>): Set<Byte> | infix fun ByteArray.union(other: Iterable<Byte>): Set<Byte> | ||
| سطر 23: | سطر 23: | ||
infix fun CharArray.union(other: Iterable<Char>): Set<Char> | infix fun CharArray.union(other: Iterable<Char>): Set<Char> | ||
| − | |||
infix fun <T> Iterable<T>.union(other: Iterable<T>): Set<T> | infix fun <T> Iterable<T>.union(other: Iterable<T>): Set<T> | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| − | == | + | |
| − | [[Kotlin/ | + | == المعاملات == |
| + | |||
| + | === <code>other</code> === | ||
| + | [[Kotlin/Iterable|المجموعة التكرارية]] الأخرى التي ستطبق عليها العملية. | ||
| + | |||
| + | ==القيمة المعادة== | ||
| + | تعاد مجموعة من النوع [[Kotlin/collections/Set|<code>Set</code>]] تحوي جميع عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Iterable|المجموعة التكرارية]] المعطاة و<nowiki/>[[Kotlin/Iterable|المجموعة التكرارية]] المُمرّرة. | ||
==أمثلة== | ==أمثلة== | ||
| − | + | استعمال الدالة <code>()union</code> لجمع العناصر المشتركة وغير المتشركة بين مصفوفة وقائمة مع حذف العناصر المتكررة:<syntaxhighlight lang="kotlin"> | |
| − | |||
fun main(args: Array<String>) { | fun main(args: Array<String>) { | ||
| − | val array = arrayOf(4, 5, 6, 4, 1, 6) | + | val array = arrayOf(4, 5, 6, 4, 1, 6) |
| − | val mutableList = mutableListOf(1, 2, 3) | + | val mutableList = mutableListOf(1, 2, 3) |
| − | + | ||
| − | println(array.union(mutableList)) // [4, 5, 6, 1, 2, 3] | + | println(array.union(mutableList)) // [4, 5, 6, 1, 2, 3] |
} | } | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| − | == | + | ==انظر أيضًا== |
| − | *<code>[[Kotlin/collections/ | + | *الدالة <code>[[Kotlin/collections/subtract|subtract()]]</code>: تستثني العناصر المشتركة بين كائنين. |
| − | *<code>[[Kotlin/collections/ | + | * الدالة <code>[[Kotlin/collections/sum|sum()]]</code>: تجمع جميع قيم عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها ثمَّ تعيد الناتج. |
| − | *<code>[[Kotlin/collections/ | + | * الدالة <code>[[Kotlin/collections/plusElement|plusElement()]]</code>: تضيف العنصر المُمرّر إليها إلى <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها. |
==مصادر== | ==مصادر== | ||
| − | * [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/union.html الدالة | + | *[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/union.html صفحة الدالة union() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] |
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
| − | [[تصنيف:Kotlin | + | [[تصنيف:Kotlin Function]] |
| + | [[تصنيف:Kotlin Collection]] | ||
المراجعة الحالية بتاريخ 11:53، 8 سبتمبر 2018
تجمع الدالة union() العناصر المشتركة وغير المتشركة بين المصفوفة أو المجموعة التكرارية التي استُدعيت معها وبين المجموعة التكرارية المُمرّرة إليها في مجموعةٍ واحدةٍ من النوع Set بعد حذف العناصر المتكررة.
تحافظ المجموعة المُعادة على نفس ترتيب تكرار المصفوفة أو المجموعة التكرارية الأصلية. تضاف عناصر المجموعة التكرارية الممرَّرة إلى الدالة وغير المتكررة في النهاية.
البنية العامة
يمكن استدعاء الدالةunion() مع المصفوفات والمجموعات التكرارية:
infix fun <T> Array<out T>.union(other: Iterable<T>): Set<T>
infix fun ByteArray.union(other: Iterable<Byte>): Set<Byte>
infix fun ShortArray.union(
other: Iterable<Short>
): Set<Short>
infix fun IntArray.union(other: Iterable<Int>): Set<Int>
infix fun LongArray.union(other: Iterable<Long>): Set<Long>
infix fun FloatArray.union(
other: Iterable<Float>
): Set<Float>
infix fun DoubleArray.union(
other: Iterable<Double>
): Set<Double>
infix fun BooleanArray.union(
other: Iterable<Boolean>
): Set<Boolean>
infix fun CharArray.union(other: Iterable<Char>): Set<Char>
infix fun <T> Iterable<T>.union(other: Iterable<T>): Set<T>
المعاملات
other
المجموعة التكرارية الأخرى التي ستطبق عليها العملية.
القيمة المعادة
تعاد مجموعة من النوع Set تحوي جميع عناصر المصفوفة أو المجموعة التكرارية المعطاة والمجموعة التكرارية المُمرّرة.
أمثلة
استعمال الدالة ()union لجمع العناصر المشتركة وغير المتشركة بين مصفوفة وقائمة مع حذف العناصر المتكررة:
fun main(args: Array<String>) {
val array = arrayOf(4, 5, 6, 4, 1, 6)
val mutableList = mutableListOf(1, 2, 3)
println(array.union(mutableList)) // [4, 5, 6, 1, 2, 3]
}
انظر أيضًا
- الدالة
subtract(): تستثني العناصر المشتركة بين كائنين. - الدالة
sum(): تجمع جميع قيم عناصر المصفوفة أو المجموعة التي استُدعيت معها ثمَّ تعيد الناتج. - الدالة
plusElement(): تضيف العنصر المُمرّر إليها إلى المصفوفة أو المجموعة التي استُدعيت معها.