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

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

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

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

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

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

أمثلة

استعمال الدالة ()sortedDescending لترتيب عناصر مصفوف تنازليًّا:

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

    print(array.sortedDescending()) // [9, 7, 6, 5, 1, -3]
}

انظر أيضًا

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

مصادر

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