الفرق بين المراجعتين لصفحة: «Kotlin/collections/sortByDescending»

المراجعة الحالية بتاريخ 11:06، 8 سبتمبر 2018

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

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

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

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

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

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

المعاملات

`selector`

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

أمثلة

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

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) التي استُدعيت معها تصاعديًّا.
الدالة sortDescending()‎: ترتِّب المصفوفة أو القائمة المتغيرة (MutableList) التي استُدعيت معها تنازليًّا.

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

مصادر

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

@@ سطر 9: / سطر 9: @@
      crossinline selector: (T) -> R?)
 </syntaxhighlight>وجود الكلمة المفتاحية <code>inline</code> يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة [[Kotlin/inline functions|الدوال المباشرة (inline functions)]]).
+== المعاملات ==
+=== <code>selector</code> ===
+دالة تطبق على كل قيمة من قيم المصفوفة أو القائمة المعطاة ثم تعيد قيمة مقابلة لكل عنصر من أجل ترتيب العناصر وفقًا لهذه القيم المعادة.
 ==أمثلة==
 استعمال الدالة <code>()sortByDescending</code> لترتيب عناصر مصفوفة تنازليًّا بحسب مربَّع كل عنصر:<syntaxhighlight lang="kotlin">
@@ سطر 31: / سطر 37: @@
 *[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/sort-by-descending.html صفحة الدالة sortByDescending()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
-[[تصنيف:Kotlin Functions]]
+[[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Collection]]