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

المراجعة الحالية بتاريخ 11:48، 8 سبتمبر 2018

تحول الدالة toSet()‎ المصفوفة أو المجموعة التكرارية التي استُدعيت معها إلى مجموعة من النوع Set. تحافظ المجموعة المُعادة على نفس ترتيب تكرار المصفوفة أو المجموعة التكرارية الأصلية.

البنية العامة

يمكن استدعاء الدالة toSet()‎ مع المصفوفات والمجموعات التكرارية:

fun <T> Array<out T>.toSet(): Set<T> 
fun ByteArray.toSet(): Set<Byte> 
fun ShortArray.toSet(): Set<Short> 
fun IntArray.toSet(): Set<Int> 
fun LongArray.toSet(): Set<Long>
fun FloatArray.toSet(): Set<Float> 
fun DoubleArray.toSet(): Set<Double> 
fun BooleanArray.toSet(): Set<Boolean> 
fun CharArray.toSet(): Set<Char> 

fun <T> Iterable<T>.toSet(): Set<T>

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

تعاد مجموعة من النوع Set تحوي جميع عناصر المصفوفة أو المجموعة التكرارية المعطاة.

أمثلة

استعمال الدالة ()toSet لتحويل مصفوفة إلى مجموعة من النوع Set:

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

    println(array.toSet()) // [4, 5, 6, 7]
    println(array.toSet().javaClass.kotlin.qualifiedName) // java.util.LinkedHashSet
}

انظر أيضًا

الدالة toBooleanArray()‎: تحول المصفوفة العامة (أي من النوع Array<out Boolean>‎) أو المجموعة التي استُدعيت معها إلى مصفوفة من القيم المنطقية (من النوع BooleanArray).
الدالة toByteArray()‎ : تحوِّل المصفوفة العامة (أي من النوع Array<Byte>‎) أو المجموعة التي استُدعيت معها إلى مصفوفة من النوع ByteArray.
الدالة toCharArray()‎: تحول المصفوفة العامة (أي التي من النوع Array<Char>‎) أو المجموعة التي استُدعيت معها إلى مصفوفة من النوع CharArray.
الدالة toCollection()‎: تضيف جميع عناصر المصفوفة أو المجموعة التي استُدعيت معها إلى المجموعة المتغيرة (MutableCollection) المُمرّرة إليها.
الدالة toDoubleArray()‎ : تحول المصفوفة العامة (أي من النوع Array<Double>‎) أو المجموعة التي استُدعيت معها إلى مصفوفة من النوع DoubleArray.
الدالة toFloatArray()‎: تحول المصفوفة العامة (أي من النوع Array<Float>‎) أو المجموعة التي استُدعيت معها مصفوفة من النوع FloatArray.
الدالة toHashSet()‎: تعيد كائنًا من النوع HashSet لجميع عناصر المصفوفة أو المجموعة التي استُدعيت معها.
الدالة toIntArray()‎: تحول المصفوفة العامة (أي من النوع Array<Int>‎) أو المجموعة التي استُدعيت معها إلى مصفوفة من النوع IntArray.
الدالة toList()‎: تحول المصفوفة أو المجموعة التكرارية أو الخريطة التي استُدعيت معها إلى قائمة.
الدالة toLongArray()‎: تحول المصفوفة العامة (أي من النوع Array<Long>‎) أو المجموعة التي استُدعيت معها إلى مصفوفة من النوع LongArray.

الدالة toMap()‎: تحول الكائن المستدعى معها إلى خريطة أو تضيف محتوى ذلك الكائن إلى خريطة موجودة مسبقًا.
الدالة toMutableList()‎: تحول المصفوف أو المجموعة التي استُدعيت معها إلى قائمة متغيرة.
الدالة toMutableSet()‎: تحول المصفوفة أو المجموعة التكرارية التي استُدعيت معها إلى مجموعة من النوع MutableSet.
الدالة toShortArray()‎: تحول المصفوفة العامة (أي من النوع Array<Short>‎) أو المجموعة التي استُدعيت معها إلى مصفوفة من النوع ShortArray.
الدالة toSortedSet()‎: تحول المصفوفة أو المجموعة التكرارية التي استُدعيت معها إلى مجموعة من النوع SortedSet ثمَّ تعيدها فقط إن لم يمرَّر إليها أي شيء، أو ترتِّبها وفقًا لترتيب معيَّن ثمَّ تعيدها إن مرِّرت إليها دالة مقارنة.

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: الدالة <code>toSet()‎</code> في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>toSet()‎</code> في Kotlin}}</noinclude>
-تعيد الدالة<code>toSet()‎</code> [[Kotlin/List|لائحة]] تضم جميع عناصر [[Kotlin/Array|المصفوفة]]   أو  [[Kotlin/Iterable|المجموعة التكرارية]]  التي استُدعيت عبرها. وفي حال استدعاء الدالة<code>toList()‎</code> عبر [[Kotlin/Map|قاموس]] فستعيد [[Kotlin/List|لائحة]] تضم جميع الأزواج مفتاح/قيمة المنتمية إليه.
+تحول الدالة <code>toSet()‎</code> [[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/Iterable|المجموعة التكرارية]] التي استُدعيت معها إلى مجموعة من النوع <code>[[Kotlin/Set|Set]]</code>. تحافظ المجموعة المُعادة على نفس ترتيب تكرار المصفوفة أو المجموعة التكرارية الأصلية.
 ==البنية العامة==
-يمكن استدعاء الدالة<code>toSet()‎</code>  عبر [[Kotlin/Array|المصفوفات]]   أو  [[Kotlin/Iterable|المجموعات التكرارية]]:<syntaxhighlight lang="kotlin">
+يمكن استدعاء الدالة <code>toSet()‎</code> مع [[Kotlin/Array|المصفوفات]] و<nowiki/>[[Kotlin/Iterable|المجموعات التكرارية]]:<syntaxhighlight lang="kotlin">
-fun <T> Array<out T>.toList(): List<T>
+fun <T> Array<out T>.toSet(): Set<T>
-fun ByteArray.toList(): List<Byte>
+fun ByteArray.toSet(): Set<Byte>
-fun ShortArray.toList(): List<Short>
+fun ShortArray.toSet(): Set<Short>
-fun IntArray.toList(): List<Int>
+fun IntArray.toSet(): Set<Int>
-fun LongArray.toList(): List<Long>
+fun LongArray.toSet(): Set<Long>
-fun FloatArray.toList(): List<Float>
+fun FloatArray.toSet(): Set<Float>
-fun DoubleArray.toList(): List<Double>
+fun DoubleArray.toSet(): Set<Double>
-fun BooleanArray.toList(): List<Boolean>
+fun BooleanArray.toSet(): Set<Boolean>
-fun CharArray.toList(): List<Char>
+fun CharArray.toSet(): Set<Char>
-fun <T> Iterable<T>.toList(): List<T>
-</syntaxhighlight>يمكن استدعاء الدالة<code>toSet()‎</code>  عبر [[Kotlin/Map|القواميس]]:<syntaxhighlight lang="kotlin">
+fun <T> Iterable<T>.toSet(): Set<T>
-fun <K, V> Map<out K, V>.toList(): List<Pair<K, V>>
 </syntaxhighlight>
-==القيمة المُعادة==
+==القيمة المعادة==
-[[Kotlin/List|لائحة]] تضم جميع عناصر [[Kotlin/Array|المصفوفة]]   أو  [[Kotlin/Iterable|المجموعة التكرارية]]  التي استُدعيت عبرها. وفي حال استدعاء الدالة<code>toList()‎</code> عبر [[Kotlin/Map|قاموس]] فستعيد [[Kotlin/List|لائحة]] تضم جميع الأزواج مفتاح/قيمة المنتمية إليه.
+تعاد مجموعة من النوع <code>[[Kotlin/collections/Set|Set]]</code> تحوي جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/Iterable|المجموعة التكرارية]] المعطاة.
 ==أمثلة==
-===استخدام الدالة <code>()toSet</code> مع المصفوفات===
+<nowiki/>استعمال الدالة <code>()toSet</code> لتحويل مصفوفة إلى مجموعة من النوع <code>[[Kotlin/collections/Set|Set]]</code>:<syntaxhighlight lang="kotlin">
-تعرّف الشيفرة الآتية  <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code>  مكونة من ثلاثة أعداد باستخدام الدالة <code>()arrayOf‎</code>، ثم تستخدم الدالة<code>()toSet</code> على <code>array</code>، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
-val array = arrayOf(4, 5, 6)
+    val array = arrayOf(4, 5, 6, 4, 7, 6)
-println(array.toList()) // [4, 5, 6]
+    println(array.toSet()) // [4, 5, 6, 7]
+    println(array.toSet().javaClass.kotlin.qualifiedName) // java.util.LinkedHashSet
 }
 </syntaxhighlight>
-==أنظر أيضًا==
+==انظر أيضًا==
-*<code>[[Kotlin/collections/toBooleanArray|toBooleanArray()]]</code>‎ : تعيد [[Kotlin/Array|مصفوفة]] من القيم المنطقية (من النوع <code>BooleanArray</code>) تضم جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة العامة]] (أي من النوع<code>Array<out Boolean>‎</code>) أو <nowiki/>[[Kotlin/collections|المجموعة]]  التي استُدعيت عبرها.
+* الدالة <code>[[Kotlin/collections/toBooleanArray|toBooleanArray()]]</code>‎: تحول <nowiki/>[[Kotlin/Array|المصفوفة العامة]] (أي من النوع <code>Array<out Boolean>‎</code>) أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها إلى <nowiki/>[[Kotlin/Array|مصفوفة]] من القيم المنطقية (من النوع <code>[[Kotlin/BooleanArray/index|BooleanArray]]</code>).
-*<code>[[Kotlin/collections/toByteArray|toByteArray()]]</code>‎ : تعيد <nowiki/>[[Kotlin/Array|مصفوفة]] من النوع <code>ByteArray</code>تضم جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة العامة]] (أي من النوع <code>Array<Byte>‎</code>) أو <nowiki/>[[Kotlin/collections|المجموعة]]  التي استُدعيت عبرها.
+* الدالة <code>[[Kotlin/collections/toByteArray|toByteArray()]]</code>‎ : تحوِّل <nowiki/>[[Kotlin/Array|المصفوفة العامة]] (أي من النوع <code>Array<Byte>‎</code>) أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها إلى <nowiki/>[[Kotlin/Array|مصفوفة]] من النوع <code>ByteArray</code>.
-*<code>[[Kotlin/collections/toDoubleArray|toDoubleArray()]]</code>‎ : تعيد [[Kotlin/Array|مصفوفة]] من  النوع <code>DoubleArray</code>تضم جميع عناصر [[Kotlin/Array|المصفوفة العامة]] (أي من النوع <code>Array<Double>‎</code>) أو  [[Kotlin/collections|المجموعة]]  التي استُدعيت عبرها.
+* الدالة <code>[[Kotlin/collections/toCharArray|toCharArray()‎]]</code>: تحول <nowiki/>[[Kotlin/Array|المصفوفة العامة]] (أي التي من النوع <code>Array<Char>‎</code>) أو <nowiki/>[[Kotlin/collections|المجموعة]]  التي استُدعيت معها إلى <nowiki/>[[Kotlin/Array|مصفوفة]] من النوع <code>[[Kotlin/CharArray/index|CharArray]]</code>.
+* الدالة <code>[[Kotlin/collections/toCollection|toCollection()‎]]</code>: تضيف جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها إلى المجموعة المتغيرة (MutableCollection) المُمرّرة إليها.
+* الدالة <code>[[Kotlin/collections/toDoubleArray|toDoubleArray()]]</code>‎ : تحول <nowiki/>[[Kotlin/Array|المصفوفة العامة]] (أي من النوع <code>Array<Double>‎</code>) أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها إلى <nowiki/>[[Kotlin/Array|مصفوفة]] من النوع <code>[[Kotlin/DoubleArray/index|DoubleArray]]</code>.
+* الدالة <code>[[Kotlin/collections/toFloatArray|toFloatArray()‎]]</code>: تحول <nowiki/>[[Kotlin/Array|المصفوفة العامة]] (أي من النوع <code>Array<Float>‎</code>) أو <nowiki/>[[Kotlin/collections|المجموعة]]  التي استُدعيت معها <nowiki/>[[Kotlin/Array|مصفوفة]] من النوع <code>[[Kotlin/FloatArray/index|FloatArray]]</code>.
+* الدالة <code>[[Kotlin/collections/toHashSet|toHashSet()]]‎</code>: تعيد كائنًا من النوع <code>HashSet</code> لجميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها.
+* الدالة <code>[[Kotlin/collections/toIntArray|toIntArray()‎]]</code>: تحول <nowiki/>[[Kotlin/Array|المصفوفة العامة]] (أي من النوع <code>Array<Int>‎</code>) أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها إلى <nowiki/>[[Kotlin/Array|مصفوفة]] من النوع <code>IntArray</code>.
+* الدالة <code>[[Kotlin/collections/toList|toList()‎]]</code>: تحول <nowiki/>[[Kotlin/Array|المصفوفة]] أو المجموعة التكرارية أو الخريطة التي استُدعيت معها إلى قائمة.
+* الدالة <code>[[Kotlin/collections/toLongArray|toLongArray()‎]]</code>: تحول <nowiki/>[[Kotlin/Array|المصفوفة العامة]] (أي من النوع <code>Array<Long>‎</code>) أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها إلى <nowiki/>[[Kotlin/Array|مصفوفة]] من النوع <code>LongArray</code>.
+*الدالة <code>[[Kotlin/collections/toMap|toMap()‎]]</code>: تحول الكائن المستدعى معها إلى خريطة أو تضيف محتوى ذلك الكائن إلى خريطة موجودة مسبقًا.
+*الدالة <code>[[Kotlin/collections/toMutableList|toMutableList()‎]]</code>: تحول [[Kotlin/Array|المصفوف]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت معها إلى [[Kotlin/MutableList|قائمة متغيرة]].
+*الدالة <code>[[Kotlin/collections/toMutableSet|toMutableSet()‎]]</code>: تحول [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Iterable|المجموعة التكرارية]] التي استُدعيت معها إلى مجموعة من النوع <code>MutableSet</code>.
+*الدالة <code>[[Kotlin/collections/toShortArray|toShortArray()‎]]</code>: تحول [[Kotlin/Array|المصفوفة العامة]] (أي من النوع <code>Array<Short>‎</code>) أو [[Kotlin/collections|المجموعة]] التي استُدعيت معها إلى [[Kotlin/Array|مصفوفة]] من النوع <code>ShortArray</code>.
+*الدالة <code>[[Kotlin/collections/toSortedSet|toSortedSet()‎]]</code>: تحول [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Iterable|المجموعة التكرارية]] التي استُدعيت معها إلى مجموعة من النوع [[Kotlin/SortedSet|<code>SortedSet</code>]] ثمَّ تعيدها فقط إن لم يمرَّر إليها أي شيء، أو ترتِّبها وفقًا لترتيب معيَّن ثمَّ تعيدها إن مرِّرت إليها دالة مقارنة.
 ==مصادر==
-* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/to-list.html الدالة  toSet()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/to-set.html صفحة الدالة toSet()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
-[[تصنيف:Kotlin Functions]]
+[[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Collection]]