الدالة sortedBy()
في لغة Kotlin
< Kotlin | collections
تعيد الدالة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()
: تعيد لائحة تضم عناصر المصفوفة أو المجموعة التكرارية التي استُدعيت عبرها مرتبة وفق الترتيب الطبيعي.