الفرق بين المراجعتين ل"Kotlin/collections/sortedDescending"
< Kotlin | collections
اذهب إلى التنقل
اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>sortedDescending()</code> في لغة Kotlin}}</noinclude> تعيد الدالة<code>sortedDescending()</code> Kot...') |
|||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: الدالة <code>sortedDescending()</code> في لغة Kotlin}}</noinclude> | <noinclude>{{DISPLAYTITLE: الدالة <code>sortedDescending()</code> في لغة Kotlin}}</noinclude> | ||
| − | تعيد الدالة<code>sortedDescending()</code> [[Kotlin/List|لائحة]] تضم عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Iterable|المجموعة التكرارية]] التي استُدعيت عبرها مرتبة | + | تعيد الدالة<code>sortedDescending()</code> [[Kotlin/List|لائحة]] تضم عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Iterable|المجموعة التكرارية]] التي استُدعيت عبرها مرتبة تنازليًا. |
==البنية العامة== | ==البنية العامة== | ||
<nowiki/><nowiki/><syntaxhighlight lang="kotlin"> | <nowiki/><nowiki/><syntaxhighlight lang="kotlin"> | ||
| − | fun <T : Comparable<T>> Array<out T>. | + | fun <T : Comparable<T>> Array<out T>.sortedDescending(): List<T> |
| − | fun ByteArray. | + | fun ByteArray.sortedDescending(): List<Byte> |
| − | fun ShortArray. | + | fun ShortArray.sortedDescending(): List<Short> |
| − | fun IntArray. | + | fun IntArray.sortedDescending(): List<Int> |
| − | fun LongArray. | + | fun LongArray.sortedDescending(): List<Long> |
| − | fun FloatArray. | + | fun FloatArray.sortedDescending(): List<Float> |
| − | fun DoubleArray. | + | fun DoubleArray.sortedDescending(): List<Double> |
| − | fun CharArray. | + | fun CharArray.sortedDescending(): List<Char> |
| − | fun <T : Comparable<T>> Iterable<T>. | + | fun <T : Comparable<T>> Iterable<T>.sortedDescending(): List<T> |
</syntaxhighlight> | </syntaxhighlight> | ||
== القيمة المُعادة == | == القيمة المُعادة == | ||
| − | [[Kotlin/List|لائحة]] تضم عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Iterable|المجموعة التكرارية]] التي استُدعيت عبرها مرتبة | + | [[Kotlin/List|لائحة]] تضم عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Iterable|المجموعة التكرارية]] التي استُدعيت عبرها مرتبة تنازليًا. |
==أمثلة== | ==أمثلة== | ||
===استخدام الدالة <code>()sortedDescending</code> مع المصفوفات=== | ===استخدام الدالة <code>()sortedDescending</code> مع المصفوفات=== | ||
| − | تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]]<nowiki/>باسم <code>array</code> مكونة من ستة عناصر باستخدام الدالة <code>()arrayOf</code>، ثم تستخدم الدالة<code>()sortedDescending</code> على <code>array</code> | + | تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]]<nowiki/>باسم <code>array</code> مكونة من ستة عناصر باستخدام الدالة <code>()arrayOf</code>، ثم تستخدم الدالة<code>()sortedDescending</code> على <code>array</code> لترتيبها تنازليًا، ثم تطبع الناتج:<syntaxhighlight lang="kotlin"> |
fun main(args: Array<String>) { | fun main(args: Array<String>) { | ||
val array = arrayOf(1, 9, -3, 7, 5, 6) | val array = arrayOf(1, 9, -3, 7, 5, 6) | ||
| − | + | print (array.sortedDescending()) // [9, 7, 6, 5, 1, -3] | |
| − | print (array. | ||
} | } | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| سطر 32: | سطر 31: | ||
* <code>[[Kotlin/collections/sort|sort()]]</code> : تقوم بترتيب <nowiki/>[[Kotlin/Array|المصفوفة]] أو اللائحة المتغيرة (<code>MutableList</code>) التي استُدعيت عبرها. | * <code>[[Kotlin/collections/sort|sort()]]</code> : تقوم بترتيب <nowiki/>[[Kotlin/Array|المصفوفة]] أو اللائحة المتغيرة (<code>MutableList</code>) التي استُدعيت عبرها. | ||
| + | |||
| + | * <code>[[Kotlin/collections/sorted|sorted()]]</code> : تعيد لائحة تضم عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو المجموعة التكرارية التي استُدعيت عبرها مرتبة وفق الترتيب الطبيعي. | ||
| + | * <code>[[Kotlin/collections/sortedBy|sortedBy()]]</code> : تعيد لائحة تضم عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو المجموعة التكرارية التي استُدعيت عبرها مرتبة ترتيبًا طبيعيًا وفقًا للقيم التي تعيدها الدالة المُمرّرة <code>selector</code>. | ||
==مصادر== | ==مصادر== | ||
| − | *[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/sorted.html الدالة sortedDescending() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] | + | *[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/sorted-descending.html الدالة sortedDescending() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] |
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
[[تصنيف:Kotlin Functions]] | [[تصنيف:Kotlin Functions]] | ||
مراجعة 19:09، 6 يونيو 2018
تعيد الدالةsortedDescending() لائحة تضم عناصر المصفوفة أو المجموعة التكرارية التي استُدعيت عبرها مرتبة تنازليًا.
البنية العامة
fun <T : Comparable<T>> Array<out T>.sortedDescending(): List<T>
fun ByteArray.sortedDescending(): List<Byte>
fun ShortArray.sortedDescending(): List<Short>
fun IntArray.sortedDescending(): List<Int>
fun LongArray.sortedDescending(): List<Long>
fun FloatArray.sortedDescending(): List<Float>
fun DoubleArray.sortedDescending(): List<Double>
fun CharArray.sortedDescending(): List<Char>
fun <T : Comparable<T>> Iterable<T>.sortedDescending(): List<T>
القيمة المُعادة
لائحة تضم عناصر المصفوفة أو المجموعة التكرارية التي استُدعيت عبرها مرتبة تنازليًا.
أمثلة
استخدام الدالة ()sortedDescending مع المصفوفات
تعرف الشيفرة الآتية مصفوفةباسم array مكونة من ستة عناصر باستخدام الدالة ()arrayOf، ثم تستخدم الدالة()sortedDescending على array لترتيبها تنازليًا، ثم تطبع الناتج:
fun main(args: Array<String>) {
val array = arrayOf(1, 9, -3, 7, 5, 6)
print (array.sortedDescending()) // [9, 7, 6, 5, 1, -3]
}
أنظر أيضًا
sortBy() : تقوم بترتيب المصفوفة أو اللائحة المتغيرة (MutableList) التي استُدعيت عبرها وفقًا للقيم التي تعيدها الدالة المُمرّرة .
sorted() : تعيد لائحة تضم عناصر المصفوفة أو المجموعة التكرارية التي استُدعيت عبرها مرتبة وفق الترتيب الطبيعي.sortedBy() : تعيد لائحة تضم عناصر المصفوفة أو المجموعة التكرارية التي استُدعيت عبرها مرتبة ترتيبًا طبيعيًا وفقًا للقيم التي تعيدها الدالة المُمرّرةselector.