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

مراجعة 17:55، 6 يونيو 2018

تقوم الدالة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.

@@ سطر 1: / سطر 1: @@
 <noinclude>{{DISPLAYTITLE: الدالة <code>sortByDescending()‎</code> في لغة Kotlin}}</noinclude>
-تقوم الدالة<code>sortByDescending()‎</code> بترتيب  [[Kotlin/Array|المصفوفة]] أو [[kotlin/MutableList|اللائحة المتغيرة]] (<code>MutableList</code>) التي استُدعيت عبرها وفقًا للقيم التي تعيدها الدالة المُمرّرة <code>selector</code>.
+تقوم الدالة<code>sortByDescending()‎</code> بترتيب  [[Kotlin/Array|المصفوفة]] أو [[kotlin/MutableList|اللائحة المتغيرة]] (<code>MutableList</code>) التي استُدعيت عبرها تنازليًا وفقًا للترتيب الطبيعي للقيم التي تعيدها الدالة المُمرّرة <code>selector</code>.
 ==البنية العامة==
@@ سطر 12: / سطر 12: @@
 ==أمثلة==
 ===استخدام الدالة <code>()sortByDescending</code> مع المصفوفات===
-تعرف الشيفرة الآتية  <nowiki/>[[Kotlin/Array|مصفوفة]] <nowiki/>باسم <code>array</code> مكونة من ستة عناصر باستخدام الدالة <code>()arrayOf‎</code>، ثم تستخدم الدالة<code>()sortByDescending</code>  على <code>array</code> لترتيبه مع تمرير دالة كوسيط، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
+تعرف الشيفرة الآتية  <nowiki/>[[Kotlin/Array|مصفوفة]] <nowiki/>باسم <code>array</code> مكونة من ستة عناصر باستخدام الدالة <code>()arrayOf‎</code>، ثم تستخدم الدالة<code>()sortByDescending</code>  على <code>array</code> لترتيبه تنازليًا مع تمرير دالة كوسيط، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
 import java.util.Arrays
@@ سطر 18: / سطر 18: @@
 val array = arrayOf(1, -9, -3, 7, 5, 6)
-array.sortBy({it*it})
+array.sortByDescending {it*it}
-print (Arrays.toString(array)) // [1, -3, 5, 6, 7, -9]
+print (Arrays.toString(array)) // [-9, 7, 6, 5, -3, 1]
 }
 </syntaxhighlight>
 ===أنظر أيضًا===
 *<code>[[Kotlin/collections/sort|sort()]]</code>‎ : تقوم بترتيب  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/MutableList|اللائحة المتغيرة]] (<code>MutableList</code>) التي استُدعيت عبرها.
+* <code>[[Kotlin/collections/sortBy|sortBy()]]</code>‎ : تقوم بترتيب <nowiki/>[[Kotlin/Array|المصفوفة]] أو اللائحة المتغيرة (<code>MutableList</code>) التي استُدعيت عبرها وفقًا للقيم التي تعيدها الدالة المُمرّرة .
 ==مصادر==
-*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/sort-by.html الدالة  sortByDescending()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/sort-by-descending.html الدالة  sortByDescending()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
 [[تصنيف:Kotlin Functions]]