الفرق بين المراجعتين ل"Kotlin/collections/sortByDescending"
< Kotlin | collections
اذهب إلى التنقل
اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>sortByDescending()</code> في لغة Kotlin}}</noinclude> تقوم الدالة<code>sortByDescending()</code> بت...') |
|||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: الدالة <code>sortByDescending()</code> في لغة Kotlin}}</noinclude> | <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> مع المصفوفات=== | ===استخدام الدالة <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 | import java.util.Arrays | ||
| سطر 18: | سطر 18: | ||
val array = arrayOf(1, -9, -3, 7, 5, 6) | val array = arrayOf(1, -9, -3, 7, 5, 6) | ||
| − | array. | + | array.sortByDescending {it*it} |
| − | print (Arrays.toString(array)) // [ | + | print (Arrays.toString(array)) // [-9, 7, 6, 5, -3, 1] |
} | } | ||
</syntaxhighlight> | </syntaxhighlight> | ||
===أنظر أيضًا=== | ===أنظر أيضًا=== | ||
*<code>[[Kotlin/collections/sort|sort()]]</code> : تقوم بترتيب [[Kotlin/Array|المصفوفة]] أو [[Kotlin/MutableList|اللائحة المتغيرة]] (<code>MutableList</code>) التي استُدعيت عبرها. | *<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]] | ||
[[تصنيف:Kotlin Functions]] | [[تصنيف:Kotlin Functions]] | ||
مراجعة 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) التي استُدعيت عبرها وفقًا للقيم التي تعيدها الدالة المُمرّرة .