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

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

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

fun CharSequence.minWith(
    comparator: Comparator<in Char>
): Char?

وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)).

المعاملات

comparator

دالةٌ تمثل الموزان الذي سيُطبَّق على كل محرف من محارف السلسلة المعطاة.

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

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

أمثلة

مثالٌ على استعمال الدالة minWith()‎:

fun main(args: Array<String>) {
    val str = "HsoubWiki"
    val comp = Comparator { x: Char, y: Char -> y.toInt() - x.toByte() }

    print(str.minWith(comp)) // u
}

انظر أيضًا

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

مصادر

• صفحة الدالة text.minWith()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.