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

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

ترتِّب الدالة sortedArrayDescending()‎ جميع عناصر المصفوفة التي استُدعيت معها تنازليًّا ثمَّ تضع الناتج في مصفوفة جديدة.

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

fun <T : Comparable<T>> Array<T>.sortedArrayDescending(): Array<T> 
fun ByteArray.sortedArrayDescending(): ByteArray 
fun ShortArray.sortedArrayDescending(): ShortArray 
fun IntArray.sortedArrayDescending(): IntArray 
fun LongArray.sortedArrayDescending(): LongArray 
fun FloatArray.sortedArrayDescending(): FloatArray 
fun DoubleArray.sortedArrayDescending(): DoubleArray 
fun CharArray.sortedArrayDescending(): CharArray

القيمة المعادة

تعاد مصفوفة جديدة تضم عناصر المصفوفة المعطاة بعد ترتيبها تصاعديًّا.

أمثلة

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

import java.util.Arrays

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

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

انظر أيضًا

الدالة sorted()‎: جميع عناصر المصفوفة أو المجموعة التكرارية التي استُدعيت معها تصاعديًّا ثمَّ تضع الناتج في قائمة.
الدالة sortedArray()‎: ترتِّب جميع عناصر المصفوفة التي استُدعيت معها تصاعديًّا ثمَّ تضع الناتج في مصفوفة جديدة.
الدالة sortedArrayWith()‎: ترتِّب جميع عناصر المصفوفة التي استُدعيت معها وفقًا للمُقارِن المُمرّر إليها ثمَّ تضع الناتج في مصفوفة جديدة.
الدالة sortedBy()‎: عناصر المصفوفة أو القائمة المتغيرة (MutableList) التي استُدعيت معها تصاعديًّا وفقًا للقيم التي تعيدها الدالة المُمرّرة إليها عند تطبيقها على كل عنصر.
الدالة sortedByDescending()‎: ترتِّب جميع عناصر المصفوفة أو المجموعة التكرارية (Iterable) التي استُدعيت معها تنازليًّا وفقًا للقيم التي تعيدها الدالة المُمرّرة إليها عند تطبيقها على كل عنصر ثمَّ تضع الناتج في قائمة.
الدالة sortedDescending()‎: ترتِّب جميع عناصر المصفوفة أو المجموعة التكرارية التي استُدعيت معها تنازليًّا ثمَّ تضع الناتج في قائمة.
الدالة sortedWith()‎: ترتِّب جميع عناصر المصفوفة أو المجموعة التكرارية التي استُدعيت معها وفقًا للمُقارِن المُمرّر إليها ثمَّ تضع الناتج في قائمة.
الدالة sortDescending()‎: ترتِّب المصفوفة أو القائمة المتغيرة (MutableList) التي استُدعيت معها تنازليًّا.

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: الدالة <code>sortedArrayDescending()‎</code> في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>sortedArrayDescending()‎</code> في Kotlin}}</noinclude>
-تعيد الدالة<code>sortedArrayDescending()‎</code> [[Kotlin/Array|مصفوفة]] تضم عناصر [[Kotlin/Array|المصفوفة]] التي استُدعيت عبرها مرتبة ترتيبًا تنازليًا.
+ترتِّب الدالة <code>sortedArrayDescending()‎</code> جميع عناصر [[Kotlin/Array|المصفوفة]] التي استُدعيت معها تنازليًّا ثمَّ تضع الناتج في [[Kotlin/Array|مصفوفة]] جديدة.
 ==البنية العامة==
-<nowiki/><nowiki/><syntaxhighlight lang="kotlin">
+<syntaxhighlight lang="kotlin">
 fun <T : Comparable<T>> Array<T>.sortedArrayDescending(): Array<T>
 fun ByteArray.sortedArrayDescending(): ByteArray
@@ سطر 13: / سطر 12: @@
 fun CharArray.sortedArrayDescending(): CharArray
 </syntaxhighlight>
+==القيمة المعادة==
-== القيمة المُعادة ==
+تعاد [[Kotlin/Array|مصفوفة]] جديدة تضم عناصر [[Kotlin/Array|المصفوفة]] المعطاة بعد ترتيبها تصاعديًّا.
-[[Kotlin/Array|مصفوفة]] تضم عناصر [[Kotlin/Array|المصفوفة]] التي استُدعيت عبرها مرتبة ترتيبًا تنازليًا.
 ==أمثلة==
-===استخدام الدالة <code>()sortedArrayDescending</code> مع المصفوفات===
+استعمال الدالة <code>()sortedArrayDescending</code> لترتيب عناصر مصفوفة تنازليًّا:<syntaxhighlight lang="kotlin">
-تعرف الشيفرة الآتية  <nowiki/>[[Kotlin/Array|مصفوفة]] <nowiki/>باسم <code>array</code> مكونة من ستة عناصر باستخدام الدالة <code>()arrayOf‎</code>، ثم تستخدم الدالة <code>()sortedArrayDescending</code>  على <code>array</code> لترتيبها تنازيليًا، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
 import java.util.Arrays
 fun main(args: Array<String>) {
-val array = arrayOf(1, 9, -3, 7, 5, 6)
+    val array = arrayOf(1, 9, -3, 7, 5, 6)
-print (Arrays.toString (array.sortedArrayDescending()) ) // [9, 7, 6, 5, 1, -3]
+     print(Arrays.toString(array.sortedArrayDescending())) // [9, 7, 6, 5, 1, -3]
 }
 </syntaxhighlight>
-==أنظر أيضًا==
+==انظر أيضًا==
-*<code>[[Kotlin/collections/sortBy|sortBy()]]</code>‎ : تقوم بترتيب  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/MutableList|اللائحة المتغيرة]] (<code>MutableList</code>) التي استُدعيت عبرها وفقًا للقيم التي تعيدها الدالة المُمرّرة .
+*الدالة <code>[[Kotlin/collections/sorted|sorted()]]</code>‎: جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو المجموعة التكرارية التي استُدعيت معها تصاعديًّا ثمَّ تضع الناتج في قائمة.
+*الدالة <code>[[Kotlin/collections/sortedArray|sortedArray()‎]]</code>: ترتِّب جميع عناصر [[Kotlin/Array|المصفوفة]] التي استُدعيت معها تصاعديًّا ثمَّ تضع الناتج في [[Kotlin/Array|مصفوفة]] جديدة.
-* <code>[[Kotlin/collections/sort|sort()]]</code>‎ : تقوم بترتيب <nowiki/>[[Kotlin/Array|المصفوفة]] أو اللائحة المتغيرة (<code>MutableList</code>) التي استُدعيت عبرها.
+*الدالة <code>[[Kotlin/collections/sortedArrayWith|sortedArrayWith()‎]]</code>: ترتِّب جميع عناصر [[Kotlin/Array|المصفوفة]] التي استُدعيت معها وفقًا للمُقارِن المُمرّر إليها ثمَّ تضع الناتج في مصفوفة جديدة.
-* <code>[[Kotlin/collections/sorted|sorted()]]</code>‎ : تعيد لائحة تضم عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو المجموعة التكرارية التي استُدعيت عبرها مرتبة وفق الترتيب الطبيعي.
+*الدالة <code>[[Kotlin/collections/sortedBy|sortedBy()]]</code>‎: عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو القائمة المتغيرة (MutableList) التي استُدعيت معها تصاعديًّا وفقًا للقيم التي تعيدها الدالة المُمرّرة إليها عند تطبيقها على كل عنصر.
+*الدالة <code>[[Kotlin/collections/sortedByDescending|sortedByDescending()‎]]</code>: ترتِّب جميع عناصر [[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/Iterable|المجموعة التكرارية]] (Iterable) التي استُدعيت معها تنازليًّا وفقًا للقيم التي تعيدها الدالة المُمرّرة إليها عند تطبيقها على كل عنصر ثمَّ تضع الناتج في قائمة.
+*الدالة <code>[[Kotlin/collections/sortedDescending|sortedDescending()‎]]</code>: ترتِّب جميع عناصر [[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/Iterable|المجموعة التكرارية]] التي استُدعيت معها تنازليًّا ثمَّ تضع الناتج في [[Kotlin/List|قائمة]].
+*الدالة <code>[[Kotlin/collections/sortedWith|sortedWith()‎]]</code>: ترتِّب جميع عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Iterable|المجموعة التكرارية]] التي استُدعيت معها وفقًا للمُقارِن المُمرّر إليها ثمَّ تضع الناتج في قائمة.
+* الدالة <code>[[Kotlin/collections/sortDescending|sortDescending()‎]]</code>: ترتِّب <nowiki/>[[Kotlin/Array|المصفوفة]] أو القائمة المتغيرة (MutableList) التي استُدعيت معها تنازليًّا.
 ==مصادر==
-*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/sorted-array-descending.html الدالة  sortedArrayDescending()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/sorted-array-descending.html صفحة الدالة sortedArrayDescending()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
-[[تصنيف:Kotlin Functions]]
+[[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Collection]]