الدالة toSortedSet()‎ في Kotlin

تحول الدالة toSortedSet()‎ المصفوفة أو المجموعة التكرارية التي استُدعيت معها إلى مجموعة من النوع SortedSet ثمَّ تعيدها فقط إن لم يمرَّر إليها أي شيء، أو ترتِّبها وفقًا لترتيب معيَّن ثمَّ تعيدها إن مرِّرت إليها دالة مقارنة.

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

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

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

ويمكن استدعاؤها مع المصفوفات أو المجموعات التكرارية ومع تمرير الدالة comparator المقارنة لترتيب العناصر وفقًا لما تحدده هذه الدالة:

fun <T> Array<out T>.toSortedSet(
    comparator: Comparator<in T>
): SortedSet<T>
fun <T> Iterable<T>.toSortedSet(
    comparator: Comparator<in T>
): SortedSet<T>

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

تعاد مجموعة من النوع SortedSet تحوي جميع عناصر المصفوفة أو المجموعة التكرارية المعطاة بنفس ترتيبها الأصلي إن لم تعطَ الدالة comparator، أو ترتب تلك العناصر وفقًا لترتيب محدد إن أعطيت الدالة comparator المقارنة.

أمثلة

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

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

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

انظر أيضًا

• الدالة 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.
• الدالة toSet()‎: تحول المصفوفة أو المجموعة التكرارية التي استُدعيت معها إلى مجموعة من النوع Set.
• الدالة toShortArray()‎: تحول المصفوفة العامة (أي من النوع Array<Short>‎) أو المجموعة التي استُدعيت معها إلى مصفوفة من النوع ShortArray.

مصادر

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