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

ترتِّب الدالة sortedWith()‎ جميع عناصر المصفوفة أو المجموعة التكرارية التي استُدعيت معها وفقًا للمُقارِن المُمرّر إليها ثمَّ تضع الناتج في قائمة.

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

fun <T> Array<out T>.sortedWith(
    comparator: Comparator<in T>
): List<T> 
fun ByteArray.sortedWith(
    comparator: Comparator<in Byte>
): List<Byte> 
fun ShortArray.sortedWith(
    comparator: Comparator<in Short>
): List<Short> 
fun IntArray.sortedWith(
    comparator: Comparator<in Int>
): List<Int> 
fun LongArray.sortedWith(
    comparator: Comparator<in Long>
): List<Long> 
fun FloatArray.sortedWith(
    comparator: Comparator<in Float>
): List<Float>
fun DoubleArray.sortedWith(
    comparator: Comparator<in Double>
): List<Double>
fun BooleanArray.sortedWith(
    comparator: Comparator<in Boolean>
): List<Boolean> 
fun CharArray.sortedWith(
    comparator: Comparator<in Char>
): List<Char> 
fun <T> Iterable<T>.sortedWith(
    comparator: Comparator<in T>
): List<T>

المعاملات

comparator

المقارن الذي سترتَّب العناصر وفقًا له.

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

تُعاد قائمة تضم جميع عناصر المصفوفة أو المجموعة التكرارية المعطاة بعد ترتيبها وفقًا للمُقارِن comparator المعطى.

أمثلة

استعمال الدالة ()sortedWith لترتيب عناصر مصفوفة وفقًا لناتج طرح قيمة العنصر اللاحق من قيمة العنصر السابق:

fun main(args: Array<String>) {
    val array = arrayOf(1, 9, -3, 7, 5, 6)

    print(array.sortedWith(Comparator { a, b -> b - a })) // [9, 7, 6, 5, 1, -3]
}

انظر أيضًا

• الدالة sorted()‎: جميع عناصر المصفوفة أو المجموعة التكرارية التي استُدعيت معها تصاعديًّا ثمَّ تضع الناتج في قائمة.
• الدالة sortedArray()‎: ترتِّب جميع عناصر المصفوفة التي استُدعيت معها تصاعديًّا ثمَّ تضع الناتج في مصفوفة جديدة.
• الدالة sortedArrayDescending()‎: ترتِّب جميع عناصر المصفوفة التي استُدعيت معها تنازليًّا ثمَّ تضع الناتج في مصفوفة جديدة.
• الدالة sortedArrayWith()‎: ترتِّب جميع عناصر المصفوفة التي استُدعيت معها وفقًا للمُقارِن المُمرّر إليها ثمَّ تضع الناتج في مصفوفة جديدة.  
• الدالة sortedBy()‎: عناصر المصفوفة أو القائمة المتغيرة (MutableList) التي استُدعيت معها تصاعديًّا وفقًا للقيم التي تعيدها الدالة المُمرّرة إليها عند تطبيقها على كل عنصر.
• الدالة sortedByDescending()‎: ترتِّب جميع عناصر المصفوفة أو المجموعة التكرارية (Iterable) التي استُدعيت معها تنازليًّا وفقًا للقيم التي تعيدها الدالة المُمرّرة إليها عند تطبيقها على كل عنصر ثمَّ تضع الناتج في قائمة. 
• الدالة sortedDescending()‎: ترتِّب جميع عناصر المصفوفة أو المجموعة التكرارية التي استُدعيت معها تنازليًّا ثمَّ تضع الناتج في قائمة.
• الدالة sortWith()‎: ترتِّب جميع عناصر المصفوفة أو القائمة المتغيرة (MutableList) التي استُدعيت معها أو جزءًا محدَّدًا منها تنازليًا وفقًا للمُقارن المُمرّر إليها.  

مصادر

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