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