الفرق بين المراجعتين لصفحة: «Kotlin/collections/union»

مراجعة 11:40، 24 يونيو 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>

يمكن استدعاء الدالةunion()‎ عبر المجموعات التكرارية:

infix fun <T> Iterable<T>.union(other: Iterable<T>): Set<T>

القيمة المُعادة

مجموعة من النوع Set تضم جميع عناصر المصفوفة أو المجموعة التكرارية التي استُدعيت عبرها والمجموعة التكرارية المُمرّرة.

أمثلة

استخدام الدالة `()union` مع المصفوفات

تعرّف الشيفرة الآتية مصفوفة باسم array مكونة من ثلاثة أعداد باستخدام الدالة ()arrayOf‎، ثم تستخدم الدالة()union على array، ثم تطبع الناتج:

fun main(args: Array<String>) {
val array = arrayOf(4, 5, 6)

println(array.toList()) // [4, 5, 6]
}

أنظر أيضًا

toBooleanArray()‎ : تعيد مصفوفة من القيم المنطقية (من النوع BooleanArray) تضم جميع عناصر المصفوفة العامة (أي من النوعArray<out Boolean>‎) أو المجموعة التي استُدعيت عبرها.
toByteArray()‎ : تعيد مصفوفة من النوع ByteArrayتضم جميع عناصر المصفوفة العامة (أي من النوع Array<Byte>‎) أو المجموعة التي استُدعيت عبرها.
toDoubleArray()‎ : تعيد مصفوفة من النوع DoubleArrayتضم جميع عناصر المصفوفة العامة (أي من النوع Array<Double>‎) أو المجموعة التي استُدعيت عبرها.

مصادر

الدالة union()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.

@@ سطر 1: / سطر 1: @@
 <noinclude>{{DISPLAYTITLE: الدالة <code>union()‎</code> في لغة Kotlin}}</noinclude>
-تعيد الدالة<code>union()‎</code> [[Kotlin/List|لائحة]] تضم جميع عناصر [[Kotlin/Array|المصفوفة]]   أو  [[Kotlin/Iterable|المجموعة التكرارية]]  التي استُدعيت عبرها. وفي حال استدعاء الدالة<code>toList()‎</code> عبر [[Kotlin/Map|قاموس]] فستعيد [[Kotlin/List|لائحة]] تضم جميع الأزواج مفتاح/قيمة المنتمية إليه.
+تعيد الدالة<code>union()‎</code> [[Kotlin/Set|مجموعة من النوع Set]] تضم جميع عناصر [[Kotlin/Array|المصفوفة]]   أو  [[Kotlin/Iterable|المجموعة التكرارية]]  التي استُدعيت عبرها و<nowiki/>[[Kotlin/Iterable|المجموعة التكرارية]] المُمرّرة.
+تحافظ المجموعة المُعادة على ترتيب التكرار الأصلي [[Kotlin/Array|للمصفوفة]]   أو  [[Kotlin/Iterable|المجموعة التكرارية]] التي استُدعيت عبرها، عناصر [[Kotlin/Iterable|المجموعة التكرارية]] المُمرّرة الفريدة ستوضع في النهاية.
 ==البنية العامة==
-يمكن استدعاء الدالة<code>union()‎</code>  عبر [[Kotlin/Array|المصفوفات]]   أو  [[Kotlin/Iterable|المجموعات التكرارية]]:<syntaxhighlight lang="kotlin">
+يمكن استدعاء الدالة<code>union()‎</code>  عبر [[Kotlin/Array|المصفوفات]]:<syntaxhighlight lang="kotlin">
-fun <T> Array<out T>.toList(): List<T>
+infix fun <T> Array<out T>.union(other: Iterable<T>): Set<T>
-fun ByteArray.toList(): List<Byte>
+infix fun ByteArray.union(other: Iterable<Byte>): Set<Byte>
-fun ShortArray.toList(): List<Short>
+infix fun ShortArray.union(
-fun IntArray.toList(): List<Int>
+    other: Iterable<Short>
-fun LongArray.toList(): List<Long>
+): Set<Short>
-fun FloatArray.toList(): List<Float>
+infix fun IntArray.union(other: Iterable<Int>): Set<Int>
-fun DoubleArray.toList(): List<Double>
+infix fun LongArray.union(other: Iterable<Long>): Set<Long>
-fun BooleanArray.toList(): List<Boolean>
+infix fun FloatArray.union(
-fun CharArray.toList(): List<Char>
+    other: Iterable<Float>
-fun <T> Iterable<T>.toList(): List<T>
+): Set<Float>
-</syntaxhighlight>يمكن استدعاء الدالة<code>union()‎</code>  عبر [[Kotlin/Map|القواميس]]:<syntaxhighlight lang="kotlin">
+infix fun DoubleArray.union(
-fun <K, V> Map<out K, V>.toList(): List<Pair<K, V>>
+    other: Iterable<Double>
+): Set<Double>
+infix fun BooleanArray.union(
+    other: Iterable<Boolean>
+): Set<Boolean>
+infix fun CharArray.union(other: Iterable<Char>): Set<Char>
+</syntaxhighlight>يمكن استدعاء الدالة<code>union()‎</code>  عبر  [[Kotlin/Iterable|المجموعات التكرارية]]:<syntaxhighlight lang="kotlin">
+infix fun <T> Iterable<T>.union(other: Iterable<T>): Set<T>
 </syntaxhighlight>
 ==القيمة المُعادة==
-[[Kotlin/List|لائحة]] تضم جميع عناصر [[Kotlin/Array|المصفوفة]]   أو  [[Kotlin/Iterable|المجموعة التكرارية]]  التي استُدعيت عبرها. وفي حال استدعاء الدالة<code>toList()‎</code> عبر [[Kotlin/Map|قاموس]] فستعيد [[Kotlin/List|لائحة]] تضم جميع الأزواج مفتاح/قيمة المنتمية إليه.
+[[Kotlin/Set|مجموعة من النوع Set]] تضم جميع عناصر [[Kotlin/Array|المصفوفة]]  أو  [[Kotlin/Iterable|المجموعة التكرارية]]  التي استُدعيت عبرها و<nowiki/>[[Kotlin/Iterable|المجموعة التكرارية]] المُمرّرة.
 ==أمثلة==
 ===استخدام الدالة <code>()union</code> مع المصفوفات===