الفرق بين المراجعتين ل"Kotlin/collections/minBy"
< Kotlin | collections
اذهب إلى التنقل
اذهب إلى البحث
جميل-بيلوني (نقاش | مساهمات) ط (مراجعة وتدقيق.) |
|||
سطر 1: | سطر 1: | ||
− | <noinclude>{{DISPLAYTITLE: الدالة <code>minBy()</code> في | + | <noinclude>{{DISPLAYTITLE: الدالة <code>minBy()</code> في Kotlin}}</noinclude> |
− | + | تجلب الدالة <code>minBy()</code> العنصر أو الزوج الأول من [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] أو الخريطة التي استُدعيت معها والذي أعيدت معه أصغر قيمة عند تطبيق دالة معيَّنة عليه. | |
− | |||
− | |||
− | |||
==البنية العامة== | ==البنية العامة== | ||
− | يمكن استدعاء الدالة <code>minBy()</code> | + | يمكن استدعاء الدالة <code>minBy()</code> مع [[Kotlin/Array|المصفوفات]] و [[Kotlin/collections|المجموعات]] والخرائط''':'''<syntaxhighlight lang="kotlin"> |
inline fun <T, R : Comparable<R>> Array<out T>.maxBy( | inline fun <T, R : Comparable<R>> Array<out T>.maxBy( | ||
selector: (T) -> R | selector: (T) -> R | ||
سطر 37: | سطر 34: | ||
): T? | ): T? | ||
− | |||
inline fun <K, V, R : Comparable<R>> Map<out K, V>.maxBy( | inline fun <K, V, R : Comparable<R>> Map<out K, V>.maxBy( | ||
selector: (Entry<K, V>) -> R | selector: (Entry<K, V>) -> R | ||
): Entry<K, V>? | ): Entry<K, V>? | ||
</syntaxhighlight> | </syntaxhighlight> | ||
− | ==القيم | + | ==القيم المعادة== |
− | العنصر الأول | + | يعاد العنصر أو الزوج الأول من [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] أو الخريطة المعطاة والذي أعطى أصغر قيمة عند تطبيق الدالة <code>selector</code> عليه، أو تُعاد القيمة <code>null</code> إن لم يكن هناك أي عنصر. |
− | |||
− | |||
==أمثلة== | ==أمثلة== | ||
− | + | تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code> باستخدام الدالة <code>()arrayOf</code> تحوي سلاسل نصية ثمَّ تستدعي الدالة <code>()maxBy</code> لمعرفة أقصر سلسلة نصية:<syntaxhighlight lang="kotlin"> | |
− | تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] | ||
fun main(args: Array<String>) { | fun main(args: Array<String>) { | ||
− | val array = arrayOf(" | + | val array = arrayOf("مستقل", "أكاديمية حسوب", "خمسات", "موسوعة حسوب") |
− | + | ||
− | println(array.minBy {it.length}) | + | println(array.minBy { it.length }) // مستقل |
} | } | ||
</syntaxhighlight> | </syntaxhighlight> | ||
− | + | ==انظر أيضًا== | |
− | *<code>[[Kotlin/collections/ | + | *الدالة <code>[[Kotlin/collections/maxBy|maxBy()]]</code>: تجلب العنصر أو الزوج الأول من [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] أو الخريطة التي استُدعيت معها والذي أعيدت معه أكبر قيمة عند تطبيق دالة معيَّنة عليه. |
− | |||
− | |||
+ | *الدالة <code>[[Kotlin/collections/min|min()]]</code>: تجلب أصغر عنصر في [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت معها. | ||
+ | *الدالة <code>[[Kotlin/collections/minWith|minWith()]]</code>: تجلب العنصر أو الزوج الأول من [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] أو الخريطة التي استُدعيت معها والذي له أصغر قيمة بحسب الموازن <code>comparator</code> المعطى. | ||
==مصادر== | ==مصادر== | ||
− | *[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/min-by.html الدالة | + | *[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/min-by.html صفحة الدالة minBy() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] |
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
[[تصنيف:Kotlin Functions]] | [[تصنيف:Kotlin Functions]] |
مراجعة 15:13، 25 يوليو 2018
تجلب الدالة minBy()
العنصر أو الزوج الأول من المصفوفة أو المجموعة أو الخريطة التي استُدعيت معها والذي أعيدت معه أصغر قيمة عند تطبيق دالة معيَّنة عليه.
البنية العامة
يمكن استدعاء الدالة minBy()
مع المصفوفات و المجموعات والخرائط:
inline fun <T, R : Comparable<R>> Array<out T>.maxBy(
selector: (T) -> R
): T?
inline fun <R : Comparable<R>> ByteArray.maxBy(
selector: (Byte) -> R
): Byte?
inline fun <R : Comparable<R>> ShortArray.maxBy(
selector: (Short) -> R
): Short?
inline fun <R : Comparable<R>> IntArray.maxBy(
selector: (Int) -> R
): Int?
inline fun <R : Comparable<R>> LongArray.maxBy(
selector: (Long) -> R
): Long?
inline fun <R : Comparable<R>> FloatArray.maxBy(
selector: (Float) -> R
): Float?
inline fun <R : Comparable<R>> DoubleArray.maxBy(
selector: (Double) -> R
): Double?
inline fun <R : Comparable<R>> BooleanArray.maxBy(
selector: (Boolean) -> R
): Boolean?
inline fun <R : Comparable<R>> CharArray.maxBy(
selector: (Char) -> R
): Char?
inline fun <T, R : Comparable<R>> Iterable<T>.maxBy(
selector: (T) -> R
): T?
inline fun <K, V, R : Comparable<R>> Map<out K, V>.maxBy(
selector: (Entry<K, V>) -> R
): Entry<K, V>?
القيم المعادة
يعاد العنصر أو الزوج الأول من المصفوفة أو المجموعة أو الخريطة المعطاة والذي أعطى أصغر قيمة عند تطبيق الدالة selector
عليه، أو تُعاد القيمة null
إن لم يكن هناك أي عنصر.
أمثلة
تعرف الشيفرة الآتية مصفوفة باسم array
باستخدام الدالة ()arrayOf
تحوي سلاسل نصية ثمَّ تستدعي الدالة ()maxBy
لمعرفة أقصر سلسلة نصية:
fun main(args: Array<String>) {
val array = arrayOf("مستقل", "أكاديمية حسوب", "خمسات", "موسوعة حسوب")
println(array.minBy { it.length }) // مستقل
}
انظر أيضًا
- الدالة
maxBy()
: تجلب العنصر أو الزوج الأول من المصفوفة أو المجموعة أو الخريطة التي استُدعيت معها والذي أعيدت معه أكبر قيمة عند تطبيق دالة معيَّنة عليه.
- الدالة
min()
: تجلب أصغر عنصر في المصفوفة أو المجموعة التي استُدعيت معها. - الدالة
minWith()
: تجلب العنصر أو الزوج الأول من المصفوفة أو المجموعة أو الخريطة التي استُدعيت معها والذي له أصغر قيمة بحسب الموازنcomparator
المعطى.