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

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

تعيد الدالةsortedArray()‎ مصفوفة تضم عناصر المصفوفة التي استُدعيت عبرها مرتبة وفق الترتيب الطبيعي.

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

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

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

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

أمثلة

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

تعرف الشيفرة الآتية مصفوفةباسم array مكونة من ستة عناصر باستخدام الدالة ()arrayOf‎، ثم تستخدم الدالة()sortedArray على array لترتيبه، ثم تطبع الناتج:

import java.util.Arrays

fun main(args: Array<String>) {
val array = arrayOf(1, 9, -3, 7, 5, 6)
    
print (Arrays.toString (array.sortedArray()) ) // [-3, 1, 5, 6, 7, 9]
}

أنظر أيضًا

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

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

مصادر

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

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