الدالة sortedByDescending()‎ في لغة Kotlin

تعيد الدالةsortedByDescending()‎ لائحة تضم عناصر المصفوفة أو اللائحة المتغيرة (MutableList) التي استُدعيت عبرها مرتبة وفقًا للقيم التي تعيدها الدالة المُمرّرة selector.

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

inline fun <T, R : Comparable<R>> Array<out T>.sortedBy(
    crossinline selector: (T) -> R?
): List<T> 
inline fun <R : Comparable<R>> ByteArray.sortedBy(
    crossinline selector: (Byte) -> R?
): List<Byte> 
inline fun <R : Comparable<R>> ShortArray.sortedBy(
    crossinline selector: (Short) -> R?
): List<Short> 
inline fun <R : Comparable<R>> IntArray.sortedBy(
    crossinline selector: (Int) -> R?
): List<Int> 
inline fun <R : Comparable<R>> LongArray.sortedBy(
    crossinline selector: (Long) -> R?
): List<Long> 
inline fun <R : Comparable<R>> FloatArray.sortedBy(
    crossinline selector: (Float) -> R?
): List<Float> 
inline fun <R : Comparable<R>> DoubleArray.sortedBy(
    crossinline selector: (Double) -> R?
): List<Double> 
inline fun <R : Comparable<R>> BooleanArray.sortedBy(
    crossinline selector: (Boolean) -> R?
): List<Boolean>
inline fun <R : Comparable<R>> CharArray.sortedBy(
    crossinline selector: (Char) -> R?
): List<Char> 
inline fun <T, R : Comparable<R>> Iterable<T>.sortedBy(
    crossinline selector: (T) -> R?
): List<T>

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

لائحة تضم عناصر المصفوفة أو اللائحة المتغيرة (MutableList) التي استُدعيت عبرها مرتبة وفقًا للقيم التي تعيدها الدالة المُمرّرة selector.

أمثلة

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

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

fun main(args: Array<String>) {
val array = arrayOf(1, 9, -3, 7, 5, 6)
    
print (array.sortedBy {it*it}) // [1, -3, 5, 6, 7, 9]
}

أنظر أيضًا

• sortBy()‎ : تقوم بترتيب المصفوفة أو اللائحة المتغيرة (MutableList) التي استُدعيت عبرها وفقًا للقيم التي تعيدها الدالة المُمرّرة . 

• sort()‎ : تقوم بترتيب المصفوفة أو اللائحة المتغيرة (MutableList) التي استُدعيت عبرها.
• sorted()‎ : تعيد لائحة تضم عناصر المصفوفة أو المجموعة التكرارية التي استُدعيت عبرها مرتبة وفق الترتيب الطبيعي.

مصادر

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