الفرق بين المراجعتين ل"Kotlin/collections/sorted"
< Kotlin | collections
اذهب إلى التنقل
اذهب إلى البحث
جميل-بيلوني (نقاش | مساهمات) ط |
|||
سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: الدالة <code>sorted()</code> في لغة Kotlin}}</noinclude> | <noinclude>{{DISPLAYTITLE: الدالة <code>sorted()</code> في لغة Kotlin}}</noinclude> | ||
− | + | ترتِّب الدالة <code>sorted()</code> جميع عناصر [[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/Iterable|المجموعة التكرارية]] التي استُدعيت معها تصاعديًّا ثمَّ تضع الناتج في [[Kotlin/List|قائمة]]. | |
==البنية العامة== | ==البنية العامة== | ||
سطر 15: | سطر 15: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
− | == القيمة | + | == القيمة المعادة == |
− | [[Kotlin/List| | + | تُعاد [[Kotlin/List|قائمة]] تضم عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Iterable|المجموعة التكرارية]] المعطاة بعد ترتيبها تصاعديًّا. |
==أمثلة== | ==أمثلة== | ||
− | + | <nowiki/><nowiki/>استعمال الدالة <code>()sorted</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.sorted()) // [-3, 1, 5, 6, 7, 9] | |
− | print (array.sorted()) // [-3, 1, 5, 6, 7, 9] | ||
} | } | ||
</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: | سطر 34: | ||
==مصادر== | ==مصادر== | ||
− | *[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/sorted.html الدالة | + | *[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/sorted.html صفحة الدالة sorted() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] |
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
[[تصنيف:Kotlin Functions]] | [[تصنيف:Kotlin Functions]] |
مراجعة 20:12، 7 أغسطس 2018
ترتِّب الدالة sorted()
جميع عناصر المصفوفة أو المجموعة التكرارية التي استُدعيت معها تصاعديًّا ثمَّ تضع الناتج في قائمة.
البنية العامة
fun <T : Comparable<T>> Array<out T>.sorted(): List<T>
fun ByteArray.sorted(): List<Byte>
fun ShortArray.sorted(): List<Short>
fun IntArray.sorted(): List<Int>
fun LongArray.sorted(): List<Long>
fun FloatArray.sorted(): List<Float>
fun DoubleArray.sorted(): List<Double>
fun CharArray.sorted(): List<Char>
fun <T : Comparable<T>> Iterable<T>.sorted(): List<T>
القيمة المعادة
تُعاد قائمة تضم عناصر المصفوفة أو المجموعة التكرارية المعطاة بعد ترتيبها تصاعديًّا.
أمثلة
استعمال الدالة ()sorted
لترتيب عناصر مصفوفة تصاعديًّا:
fun main(args: Array<String>) {
val array = arrayOf(1, 9, -3, 7, 5, 6)
print(array.sorted()) // [-3, 1, 5, 6, 7, 9]
}
انظر أيضًا
sortBy()
: تقوم بترتيب المصفوفة أو اللائحة المتغيرة (MutableList
) التي استُدعيت عبرها وفقًا للقيم التي تعيدها الدالة المُمرّرة .
sortedBy()
: تعيد لائحة تضم عناصر المصفوفة أو المجموعة التكرارية التي استُدعيت عبرها مرتبة ترتيبًا طبيعيًا وفقًا للقيم التي تعيدها الدالة المُمرّرةselector
.