الفرق بين المراجعتين لصفحة: «Kotlin/collections/sortedBy»
< Kotlin | collections
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>sortedBy()</code> في لغة Kotlin}}</noinclude> تعيد الدالة<code>sortedBy()</code> Kotlin/Array|مصف...' |
لا ملخص تعديل |
||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: الدالة <code>sortedBy()</code> في لغة Kotlin}}</noinclude> | <noinclude>{{DISPLAYTITLE: الدالة <code>sortedBy()</code> في لغة Kotlin}}</noinclude> | ||
تعيد الدالة<code>sortedBy()</code> [[Kotlin/ | تعيد الدالة<code>sortedBy()</code> [[Kotlin/List|لائحة]] تضم عناصر [[Kotlin/Array|المصفوفة]] أو <nowiki/>[[kotlin/MutableList|اللائحة المتغيرة]] (<code>MutableList</code>) التي استُدعيت عبرها مرتبة وفقًا للقيم التي تعيدها الدالة المُمرّرة <code>selector</code>. | ||
==البنية العامة== | ==البنية العامة== | ||
<nowiki/><nowiki/><syntaxhighlight lang="kotlin"> | <nowiki/><nowiki/><syntaxhighlight lang="kotlin"> | ||
fun <T> Array<out T>. | inline fun <T, R : Comparable<R>> Array<out T>.sortedBy( | ||
crossinline selector: (T) -> R? | |||
): | ): List<T> | ||
inline fun <R : Comparable<R>> ByteArray.sortedBy( | |||
crossinline selector: (Byte) -> R? | |||
): List<Byte> | |||
inline fun <R : Comparable<R>> ShortArray.sortedBy( | |||
crossinline selector: (Short) -> R? | |||
): List<Short> | |||
inline fun <R : Comparable<R>> IntArray.sortedBy( | |||
crossinline selector: (Int) -> R? | |||
): List<Int> | |||
inline fun <R : Comparable<R>> LongArray.sortedBy( | |||
crossinline selector: (Long) -> R? | |||
): List<Long> | |||
inline fun <R : Comparable<R>> FloatArray.sortedBy( | |||
crossinline selector: (Float) -> R? | |||
): List<Float> | |||
inline fun <R : Comparable<R>> DoubleArray.sortedBy( | |||
crossinline selector: (Double) -> R? | |||
): List<Double> | |||
inline fun <R : Comparable<R>> BooleanArray.sortedBy( | |||
crossinline selector: (Boolean) -> R? | |||
): List<Boolean> | |||
inline fun <R : Comparable<R>> CharArray.sortedBy( | |||
crossinline selector: (Char) -> R? | |||
): List<Char> | |||
inline fun <T, R : Comparable<R>> Iterable<T>.sortedBy( | |||
crossinline selector: (T) -> R? | |||
): List<T> | |||
</syntaxhighlight> | </syntaxhighlight> | ||
== القيمة المُعادة == | == القيمة المُعادة == | ||
[[Kotlin/ | [[Kotlin/List|لائحة]] تضم عناصر [[Kotlin/Array|المصفوفة]] أو <nowiki/>[[kotlin/MutableList|اللائحة المتغيرة]] (<code>MutableList</code>) التي استُدعيت عبرها مرتبة وفقًا للقيم التي تعيدها الدالة المُمرّرة <code>selector</code>. | ||
==أمثلة== | ==أمثلة== | ||
===استخدام الدالة <code>()sortedBy</code> مع المصفوفات=== | ===استخدام الدالة <code>()sortedBy</code> مع المصفوفات=== | ||
تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] <nowiki/>باسم <code>array</code> مكونة من ستة عناصر باستخدام الدالة <code>()arrayOf</code>، ثم تستخدم الدالة<code>()sortedBy</code> على <code>array</code> لترتيبه وفق | تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] <nowiki/>باسم <code>array</code> مكونة من ستة عناصر باستخدام الدالة <code>()arrayOf</code>، ثم تستخدم الدالة<code>()sortedBy</code> على <code>array</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 ( | print (array.sortedBy {it*it}) // [1, -3, 5, 6, 7, 9] | ||
} | } | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| سطر 31: | سطر 56: | ||
==مصادر== | ==مصادر== | ||
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/sorted- | *[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/sorted-by.html الدالة sortedBy() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] | ||
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
[[تصنيف:Kotlin Functions]] | [[تصنيف:Kotlin Functions]] | ||
مراجعة 18:59، 6 يونيو 2018
تعيد الدالةsortedBy() لائحة تضم عناصر المصفوفة أو اللائحة المتغيرة (MutableList) التي استُدعيت عبرها مرتبة وفقًا للقيم التي تعيدها الدالة المُمرّرة selector.
البنية العامة
inline fun <T, R : Comparable<R>> Array<out T>.sortedBy(
crossinline selector: (T) -> R?
): List<T>
inline fun <R : Comparable<R>> ByteArray.sortedBy(
crossinline selector: (Byte) -> R?
): List<Byte>
inline fun <R : Comparable<R>> ShortArray.sortedBy(
crossinline selector: (Short) -> R?
): List<Short>
inline fun <R : Comparable<R>> IntArray.sortedBy(
crossinline selector: (Int) -> R?
): List<Int>
inline fun <R : Comparable<R>> LongArray.sortedBy(
crossinline selector: (Long) -> R?
): List<Long>
inline fun <R : Comparable<R>> FloatArray.sortedBy(
crossinline selector: (Float) -> R?
): List<Float>
inline fun <R : Comparable<R>> DoubleArray.sortedBy(
crossinline selector: (Double) -> R?
): List<Double>
inline fun <R : Comparable<R>> BooleanArray.sortedBy(
crossinline selector: (Boolean) -> R?
): List<Boolean>
inline fun <R : Comparable<R>> CharArray.sortedBy(
crossinline selector: (Char) -> R?
): List<Char>
inline fun <T, R : Comparable<R>> Iterable<T>.sortedBy(
crossinline selector: (T) -> R?
): List<T>
القيمة المُعادة
لائحة تضم عناصر المصفوفة أو اللائحة المتغيرة (MutableList) التي استُدعيت عبرها مرتبة وفقًا للقيم التي تعيدها الدالة المُمرّرة selector.
أمثلة
استخدام الدالة ()sortedBy مع المصفوفات
تعرف الشيفرة الآتية مصفوفة باسم array مكونة من ستة عناصر باستخدام الدالة ()arrayOf، ثم تستخدم الدالة()sortedBy على array لترتيبه وفق القيم التي تعيدها الدالة المٌمرّرة، ثم تطبع الناتج:
fun main(args: Array<String>) {
val array = arrayOf(1, 9, -3, 7, 5, 6)
print (array.sortedBy {it*it}) // [1, -3, 5, 6, 7, 9]
}
أنظر أيضًا
sortBy() : تقوم بترتيب المصفوفة أو اللائحة المتغيرة (MutableList) التي استُدعيت عبرها وفقًا للقيم التي تعيدها الدالة المُمرّرة .
sort() : تقوم بترتيب المصفوفة أو اللائحة المتغيرة (MutableList) التي استُدعيت عبرها.sorted() : تعيد لائحة تضم عناصر المصفوفة أو المجموعة التكرارية التي استُدعيت عبرها مرتبة وفق الترتيب الطبيعي.