الفرق بين المراجعتين ل"Kotlin/collections/union"
< Kotlin | collections
اذهب إلى التنقل
اذهب إلى البحث
جميل-بيلوني (نقاش | مساهمات) ط (مراجعة وتدقيق.) |
جميل-بيلوني (نقاش | مساهمات) ط |
||
| (مراجعة متوسطة واحدة بواسطة مستخدم واحد آخر غير معروضة) | |||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: الدالة <code>union()</code> في Kotlin}}</noinclude> | <noinclude>{{DISPLAYTITLE: الدالة <code>union()</code> في Kotlin}}</noinclude> | ||
| − | <nowiki/>تجمع الدالة <code>union()</code> العناصر المشتركة وغير المتشركة بين [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Iterable|المجموعة التكرارية]] التي استُدعيت معها وبين [[Kotlin/Iterable|المجموعة التكرارية]] المُمرّرة إليها في مجموعةٍ واحدةٍ من النوع <code>[[Kotlin/Set|Set]]</code> بعد حذف العناصر المتكررة. | + | <nowiki/>تجمع الدالة <code>union()</code> العناصر المشتركة وغير المتشركة بين [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Iterable|المجموعة التكرارية]] التي استُدعيت معها وبين [[Kotlin/Iterable|المجموعة التكرارية]] المُمرّرة إليها في مجموعةٍ واحدةٍ من النوع <code>[[Kotlin/collections/Set|Set]]</code> بعد حذف العناصر المتكررة. |
تحافظ المجموعة المُعادة على نفس ترتيب تكرار [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Iterable|المجموعة التكرارية]] الأصلية. تضاف عناصر [[Kotlin/Iterable|المجموعة التكرارية]] الممرَّرة إلى الدالة وغير المتكررة في النهاية. | تحافظ المجموعة المُعادة على نفس ترتيب تكرار [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Iterable|المجموعة التكرارية]] الأصلية. تضاف عناصر [[Kotlin/Iterable|المجموعة التكرارية]] الممرَّرة إلى الدالة وغير المتكررة في النهاية. | ||
| سطر 26: | سطر 26: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| + | |||
| + | == المعاملات == | ||
| + | |||
| + | === <code>other</code> === | ||
| + | [[Kotlin/Iterable|المجموعة التكرارية]] الأخرى التي ستطبق عليها العملية. | ||
| + | |||
==القيمة المعادة== | ==القيمة المعادة== | ||
| − | تعاد [[Kotlin/Set| | + | تعاد مجموعة من النوع [[Kotlin/collections/Set|<code>Set</code>]] تحوي جميع عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Iterable|المجموعة التكرارية]] المعطاة و<nowiki/>[[Kotlin/Iterable|المجموعة التكرارية]] المُمرّرة. |
==أمثلة== | ==أمثلة== | ||
استعمال الدالة <code>()union</code> لجمع العناصر المشتركة وغير المتشركة بين مصفوفة وقائمة مع حذف العناصر المتكررة:<syntaxhighlight lang="kotlin"> | استعمال الدالة <code>()union</code> لجمع العناصر المشتركة وغير المتشركة بين مصفوفة وقائمة مع حذف العناصر المتكررة:<syntaxhighlight lang="kotlin"> | ||
| سطر 44: | سطر 50: | ||
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/union.html صفحة الدالة union() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] | *[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(): تضيف العنصر المُمرّر إليها إلى المصفوفة أو المجموعة التي استُدعيت معها.