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

مراجعة 18:51، 6 يونيو 2018

تعيد الدالةsortedArrayWith()‎ مصفوفة تضم عناصر المصفوفة التي استُدعيت عبرها مرتبة وفق المُقارِن المُمرّر comparator.

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

fun <T> Array<out T>.sortedArrayWith(
    comparator: Comparator<in T>
): Array<out T>

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

مصفوفة تضم عناصر المصفوفة التي استُدعيت عبرها مرتبة وفق المُقارِن المُمرّر comparator.

أمثلة

استخدام الدالة `()sortedArrayWith` مع المصفوفات

تعرف الشيفرة الآتية مصفوفة باسم array مكونة من ستة عناصر باستخدام الدالة ()arrayOf‎، ثم تستخدم الدالة()sortedArrayWith على array لترتيبه وفق المقارِن المُمرّر كوسيط وتضع المصفوفة المعادة في المتغير array2، ثم تطبعه:

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]
}

أنظر أيضًا

sortBy()‎ : تقوم بترتيب المصفوفة أو اللائحة المتغيرة (MutableList) التي استُدعيت عبرها وفقًا للقيم التي تعيدها الدالة المُمرّرة .

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

مصادر

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

@@ سطر 1: / سطر 1: @@
 <noinclude>{{DISPLAYTITLE: الدالة <code>sortedArrayWith()‎</code> في لغة Kotlin}}</noinclude>
-تعيد الدالة<code>sortedArrayWith()‎</code> [[Kotlin/Array|مصفوفة]] تضم عناصر [[Kotlin/Array|المصفوفة]] التي استُدعيت عبرها مرتبة وفق الترتيب الطبيعي.
+تعيد الدالة<code>sortedArrayWith()‎</code> [[Kotlin/Array|مصفوفة]] تضم عناصر [[Kotlin/Array|المصفوفة]] التي استُدعيت عبرها مرتبة وفق المُقارِن المُمرّر <code>comparator</code>.
 ==البنية العامة==
 <nowiki/><nowiki/><syntaxhighlight lang="kotlin">
-fun <T : Comparable<T>> Array<T>.sortedArray(): Array<T>
+fun <T> Array<out T>.sortedArrayWith(
-fun ByteArray.sortedArray(): ByteArray
+    comparator: Comparator<in T>
-fun ShortArray.sortedArray(): ShortArray
+): Array<out T>
-fun IntArray.sortedArray(): IntArray
-fun LongArray.sortedArray(): LongArray
-fun FloatArray.sortedArray(): FloatArray
-fun DoubleArray.sortedArray(): DoubleArray
-fun CharArray.sortedArray(): CharArray
 </syntaxhighlight>
 == القيمة المُعادة ==
-[[Kotlin/Array|مصفوفة]] تضم عناصر [[Kotlin/Array|المصفوفة]] التي استُدعيت عبرها مرتبة وفق الترتيب الطبيعي.
+[[Kotlin/Array|مصفوفة]] تضم عناصر [[Kotlin/Array|المصفوفة]] التي استُدعيت عبرها مرتبة وفق المُقارِن المُمرّر <code>comparator</code>.
 ==أمثلة==
 ===استخدام الدالة <code>()sortedArrayWith</code> مع المصفوفات===
-تعرف الشيفرة الآتية  <nowiki/>[[Kotlin/Array|مصفوفة]]<nowiki/>باسم <code>array</code> مكونة من ستة عناصر باستخدام الدالة <code>()arrayOf‎</code>، ثم تستخدم الدالة<code>()sortedArrayWith</code>  على <code>array</code> لترتيبه، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
+تعرف الشيفرة الآتية  <nowiki/>[[Kotlin/Array|مصفوفة]] <nowiki/>باسم <code>array</code> مكونة من ستة عناصر باستخدام الدالة <code>()arrayOf‎</code>، ثم تستخدم الدالة<code>()sortedArrayWith</code>  على <code>array</code> لترتيبه وفق المقارِن المُمرّر كوسيط وتضع [[Kotlin/Array|المصفوفة]] المعادة في المتغير <code>array2</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 (array.sortedArray()) ) // [-3, 1, 5, 6, 7, 9]
+print (Arrays.toString (array2 )) // [9, 7, 6, 5, 1, -3]
 }
 </syntaxhighlight>
@@ سطر 35: / سطر 31: @@
 ==مصادر==
-*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/sorted-array.html الدالة  sortedArrayWith()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/sorted-array-with.html الدالة  sortedArrayWith()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
 [[تصنيف:Kotlin Functions]]