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

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

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

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

inline fun <T, R : Comparable<R>> Array<out T>.sortBy(
    crossinline selector: (T) -> R?)

يمكن استدعاء الدالة  sortByDescending()‎ عبر كائن من النوع MutableList:

inline fun <T, R : Comparable<R>> MutableList<T>.sortBy(
    crossinline selector: (T) -> R?)

يُلاحَظ وجود الكلمة المفتاحية inline للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع توثيق الدوال المباشرة (inline functions).

أمثلة

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

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

import java.util.Arrays

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

أنظر أيضًا

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

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

مصادر

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