عرض مصدر Kotlin/collections/sortedArrayWith

<noinclude>{{DISPLAYTITLE: الدالة <code>sortedArrayWith()‎</code> في Kotlin}}</noinclude>
ترتِّب الدالة <code>sortedArrayWith()‎</code> جميع عناصر [[Kotlin/Array|المصفوفة]] التي استُدعيت معها وفقًا للمُقارِن المُمرّر إليها ثمَّ تضع الناتج في مصفوفة جديدة.  
==البنية العامة==
<syntaxhighlight lang="kotlin">
fun <T> Array<out T>.sortedArrayWith(
    comparator: Comparator<in T>
): Array<out T> 
</syntaxhighlight>

== المعاملات ==

=== <code>comparator</code> ===
[[Kotlin/Comparator|المقارن]] الذي سترتَّب العناصر وفقًا له.

==القيمة المعادة==
تُعاد [[Kotlin/Array|مصفوفة]] جديدة تضم عناصر [[Kotlin/Array|المصفوفة]] المعطاة بعد ترتيبها وفقًا للمُقارِن <code>comparator</code> المعطى.
==أمثلة==
استعمال الدالة <code>()sortedArrayWith</code> لترتيب عناصر مصفوفة وفقًا لناتج طرح قيمة العنصر اللاحق من قيمة العنصر السابق:<syntaxhighlight lang="kotlin">
import java.util.Arrays

fun main(args: Array<String>) {
val array = arrayOf(1, 9, -3, 7, 5, 6)
val array2 = array.sortedArrayWith(Comparator { a, b -> b - a })
    
print (Arrays.toString (array2 )) // [9, 7, 6, 5, 1, -3]
}
</syntaxhighlight>
==انظر أيضًا==
*الدالة <code>[[Kotlin/collections/sorted|sorted()]]</code>‎: جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو المجموعة التكرارية التي استُدعيت معها تصاعديًّا ثمَّ تضع الناتج في قائمة.
*الدالة <code>[[Kotlin/collections/sortedArray|sortedArray()‎]]</code>: ترتِّب جميع عناصر [[Kotlin/Array|المصفوفة]] التي استُدعيت معها تصاعديًّا ثمَّ تضع الناتج في [[Kotlin/List|مصفوفة]] جديدة.
*الدالة <code>[[Kotlin/collections/sortedArrayDescending|sortedArrayDescending()‎]]</code>: ترتِّب جميع عناصر [[Kotlin/Array|المصفوفة]] التي استُدعيت معها تنازليًّا ثمَّ تضع الناتج في [[Kotlin/List|مصفوفة]] جديدة.
*الدالة <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/sortWith|sortWith()‎]]</code>: ترتِّب جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو القائمة المتغيرة (MutableList) التي استُدعيت معها أو جزءًا محدَّدًا منها تنازليًا وفقًا للمُقارن المُمرّر إليها.  
==مصادر==
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/sorted-array-with.html صفحة الدالة sortedArrayWith()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Function]]
[[تصنيف:Kotlin Collection]]