الدالة CharSequence.minBy()‎ في Kotlin

من موسوعة حسوب
اذهب إلى: تصفح، ابحث

تجلب الدالة minBy()‎ المحرف من السلسلة التي استُدعيت معها والذي أعيدت معه أصغر قيمة عند تطبيق دالة معيَّنة عليه.

البنية العامة

inline fun <R : Comparable<R>> CharSequence.minBy(
    selector: (Char) -> R
): Char?
وجود الكلمة المفتاحية inline يدل على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)).

المعاملات

selector

دالةٌ تطبَّق على كل محرف من محارف السلسلة المعطاة. يمرر إليها المحرف، وتعيد قيمة مقابلة له.

القيم المعادة

يعاد المحرف من السلسلة المعطاة والذي أعطى أصغر قيمة عند تطبيق الدالة selector عليه، أو تُعاد القيمة null إن لم يكن هناك أي محرف.

أمثلة

مثال على استعمال الدالة minBy()‎:
fun main(args: Array<String>) {
    val str = "HsoubWiki"

    print(str.minBy { it.toUpperCase() }) // b
}

انظر أيضًا

  • الدالة maxBy()‎: تجلب المحرف من السلسلة التي استُدعيت معها والذي أعيدت معه أكبر قيمة عند تطبيق دالة معيَّنة عليه.
  • الدالة min()‎: تجلب أصغر محرف في سلسلة المحارف التي استُدعيت معها.
  • الدالة minWith()‎: تجلب المحرف الأول من سلسلة المحارف التي استُدعيت معها والذي له أصغر قيمة بحسب الموازن comparator المعطى.

مصادر