التابع text.maxWith()‎ في لغة Kotlin

تعيد الدالة maxWith()‎ أول حرف في سلسلة الحروف التي استٌدعيت عبرها والذي له أكبر قيمة نسبة إلى المُقارِن comparator أو تعيد null إن كانت سلسلة الحروف فارغة.

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

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

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

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

حرف.

أمثلة

استخدام الدالة maxWith()‎ مع السلاسل النصية

تُعرّف الشيفرة الآتية سلسلة نصية باسم str، وتعرّف مقارنًا باسم comp، ثم تستدعي الدالة maxWith()‎ عبر str مع تمرير comp، ثم تطبع الناتج:

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

انظر أيضًا

• min()‎: تعيد الدالة min()‎ أصغر حرف في السلسلة النصية التي استٌدعيت عبرها أو تعيد null إن كانت فارغة.

• max()‎: تعيد الدالة max()‎ أكبر حرف في السلسلة النصية التي استٌدعيت عبرها أو تعيد null إن كانت فارغة.

• minBy()‎: تعيد الدالة minBy()‎ أول حرف في سلسلة الحروف التي استٌدعيت عبرها والذي يعيد أصغر قيمة بعد تمريره إلى الدالة selector أو تعيد null إن كانت سلسلة الحروف فارغة.

مصادر

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