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

من موسوعة حسوب
لا ملخص تعديل
طلا ملخص تعديل
سطر 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/Array|المصفوفة]] أو <nowiki/>[[Kotlin/Iterable|المجموعة التكرارية]] التي استُدعيت معها تنازليًّا ثمَّ تضع الناتج في [[Kotlin/List|قائمة]].  


==البنية العامة==
==البنية العامة==
سطر 15: سطر 15:
</syntaxhighlight>
</syntaxhighlight>


== القيمة المُعادة ==
== القيمة المعادة ==
[[Kotlin/List|لائحة]] تضم عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Iterable|المجموعة التكرارية]] التي استُدعيت عبرها مرتبة تنازليًا.
تُعاد [[Kotlin/List|قائمة]] تضم عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Iterable|المجموعة التكرارية]] المعطاة بعد ترتيبها تنازليًّا.


==أمثلة==
==أمثلة==
===استخدام الدالة <code>()sortedDescending</code> مع المصفوفات===
<nowiki/><nowiki/>استعمال الدالة <code>()sortedDescending</code> لترتيب عناصر مصفوف تنازليًّا:<syntaxhighlight lang="kotlin">
تعرف الشيفرة الآتية  <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.sortedDescending()) // [9, 7, 6, 5, 1, -3]
}
}
</syntaxhighlight>
</syntaxhighlight>
==أنظر أيضًا==
==انظر أيضًا==
*<code>[[Kotlin/collections/sortBy|sortBy()]]</code>‎ : تقوم بترتيب  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/MutableList|اللائحة المتغيرة]] (<code>MutableList</code>) التي استُدعيت عبرها وفقًا للقيم التي تعيدها الدالة المُمرّرة . 
*<code>[[Kotlin/collections/sortBy|sortBy()]]</code>‎ : تقوم بترتيب  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/MutableList|اللائحة المتغيرة]] (<code>MutableList</code>) التي استُدعيت عبرها وفقًا للقيم التي تعيدها الدالة المُمرّرة . 


سطر 36: سطر 35:


==مصادر==
==مصادر==
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/sorted-descending.html الدالة  sortedDescending()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/sorted-descending.html صفحة الدالة sortedDescending()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Functions]]
[[تصنيف:Kotlin Functions]]

مراجعة 20:12، 7 أغسطس 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 لترتيب عناصر مصفوف تنازليًّا:

fun main(args: Array<String>) {
    val array = arrayOf(1, 9, -3, 7, 5, 6)

    print(array.sortedDescending()) // [9, 7, 6, 5, 1, -3]
}

انظر أيضًا

  • sort()‎ : تقوم بترتيب المصفوفة أو اللائحة المتغيرة (MutableList) التي استُدعيت عبرها.
  • sorted()‎ : تعيد لائحة تضم عناصر المصفوفة أو المجموعة التكرارية التي استُدعيت عبرها مرتبة وفق الترتيب الطبيعي.
  • sortedBy()‎ : تعيد لائحة تضم عناصر المصفوفة أو المجموعة التكرارية التي استُدعيت عبرها مرتبة ترتيبًا طبيعيًا وفقًا للقيم التي تعيدها الدالة المُمرّرة selector

مصادر